--- a/docs/ccguide/read.refentry	Wed Oct 16 20:02:22 2002 +0000
+++ b/docs/ccguide/read.refentry	Wed Oct 16 20:02:31 2002 +0000
@@ -29,6 +29,18 @@
 </para>
 </refsect1>
 
+<refsect1><title>Diagnostics</title>
+<para>
+Read and readln return the number of bytes actually read (0 at
+end-of-file) or -1 for physical i/o errors, a bad path number,
+or a ridicolous "count".
+</para>
+<para>
+NOTE that end-of-file is not considered an error, and no error
+indication is returned. Zero is returned on EOF.
+</para>
+</refsect1>
+
 <refsect1><title>See Also</title>
 <para>
 <link linkend="open">open()</link>,