Reorganized read_file loop.

1 files changed, 5 insertions, 2 deletions

diff --git a/examples/io.h b/examples/io.h
index d95c81a3..f79855da 100644
--- a/examples/io.h
+++ b/examples/io.h
@@ -39,8 +39,11 @@ xalloc(size_t size);
 void
 werror(const char *format, ...) PRINTF_STYLE(1, 2);
 
-/* If size is > 0, read at most that many bytes. If size == 0,
- * read until EOF. Allocates the buffer dynamically. */
+/* If size is > 0, read at most that many bytes. If size == 0, read
+ * until EOF. Allocates the buffer dynamically. An empty file is
+ * treated as an error; return value is zero, and no space is
+ * allocated. The returned data is NUL-terminated, for convenience. */
+
 unsigned
 read_file(const char *name, unsigned size, char **buffer);