From 54f8dea29b8ef5398749845037c73ecb88905f11 Mon Sep 17 00:00:00 2001
From: Stefan <stefan.haubenthal@gmail.com>
Date: Wed, 7 Feb 2018 17:23:23 +0100
Subject: [PATCH 1/3] Added note

---
 doc/funcref.sgml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/funcref.sgml b/doc/funcref.sgml
index c083f467e..90185a261 100644
--- a/doc/funcref.sgml
+++ b/doc/funcref.sgml
@@ -3513,6 +3513,8 @@ be used in presence of a prototype.
 It allows to access the device on filesystem level by calling chdir() with
 the directory returned.
 <tag/Notes/<itemize>
+<item>Calling getdevicedir() <em/does/ check for a (formatted) disk in a
+floppy-disk-type device and returns NULL if that check fails.
 <item>The function is only available as fastcall function, so it may only
 be used in presence of a prototype.
 </itemize>
@@ -3525,6 +3527,7 @@ be used in presence of a prototype.
 <tag/Example/<verb>
 chdir (getdevicedir (device, buf, sizeof buf));
 </verb>
+cf. <tt/samples/enumdevdir.c/
 </descrip>
 </quote>
 

From 46bdc016dbff1b4e8a10375f41a8f572b7b2934c Mon Sep 17 00:00:00 2001
From: Stefan <stefan.haubenthal@gmail.com>
Date: Wed, 7 Feb 2018 18:08:40 +0100
Subject: [PATCH 2/3] Removed empty notes

---
 doc/funcref.sgml | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/doc/funcref.sgml b/doc/funcref.sgml
index 90185a261..c3d8f9869 100644
--- a/doc/funcref.sgml
+++ b/doc/funcref.sgml
@@ -3469,9 +3469,6 @@ returns one of the constants<itemize>
 It allows to access the current device with the <ref id="dio.h"
 name="Low-level disk I/O API"> or <ref id="cbm.h" name="cbm_* I/O
 functions"> requiring a 'device' parameter.
-<tag/Notes/<itemize>
-<item>
-</itemize>
 <tag/Availability/cc65
 <tag/See also/
 <ref id="getdevicedir" name="getdevicedir">,
@@ -3564,9 +3561,6 @@ be used in presence of a prototype.
 <tag/Declaration/<tt/unsigned char getfirstdevice (void);/
 <tag/Description/The function returns the first device.
 The constant <tt/INVALID_DEVICE/ indicates no device.
-<tag/Notes/<itemize>
-<item>
-</itemize>
 <tag/Availability/cc65
 <tag/See also/
 <ref id="getcurrentdevice" name="getcurrentdevice">,

From 89799cd02eb950e89e757b2db66b972b5be4a003 Mon Sep 17 00:00:00 2001
From: Stefan <stefan.haubenthal@gmail.com>
Date: Sat, 10 Feb 2018 00:08:28 +0100
Subject: [PATCH 3/3] More notes

---
 doc/funcref.sgml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/funcref.sgml b/doc/funcref.sgml
index c3d8f9869..bbab694fa 100644
--- a/doc/funcref.sgml
+++ b/doc/funcref.sgml
@@ -3561,6 +3561,10 @@ be used in presence of a prototype.
 <tag/Declaration/<tt/unsigned char getfirstdevice (void);/
 <tag/Description/The function returns the first device.
 The constant <tt/INVALID_DEVICE/ indicates no device.
+<tag/Notes/<itemize>
+<item>Calling getfirstdevice() does <em/not/ turn on the motor of a
+drive-type device and does <em/not/ check for a disk in the drive.
+</itemize>
 <tag/Availability/cc65
 <tag/See also/
 <ref id="getcurrentdevice" name="getcurrentdevice">,
@@ -3587,6 +3591,8 @@ while (dev != INVALID_DEVICE) {
 <tag/Description/The function returns the next device after <tt/device/.
 The constant <tt/INVALID_DEVICE/ indicates no further device.
 <tag/Notes/<itemize>
+<item>Calling getnextdevice() does <em/not/ turn on the motor of a
+drive-type device and does <em/not/ check for a disk in the drive.
 <item>The function is only available as fastcall function, so it may only
 be used in presence of a prototype.
 </itemize>