make read_file_to_str_until_eof doc more explicit

the sz_out param is set to what was read (i.e not including the final
NULL the function adds for convenience), but could be understood to
be set to what was read+1 (including the NULL terminator)

diff --git a/src/lib/fs/files.c b/src/lib/fs/files.c
index 55f20dd49efa125fc8fd062ad4669f43314ede0a..df59222913d6e9e7bbb007df21e28d479067d900 100644 (file)
--- a/src/lib/fs/files.c
+++ b/src/lib/fs/files.c
@@ -572,9 +572,10 @@ write_bytes_to_new_file(const char *fname, const char *str, size_t len,
 /**
  * Read the contents of the open file <b>fd</b> presuming it is a FIFO
  * (or similar) file descriptor for which the size of the file isn't
- * known ahead of time. Return NULL on failure, and a NUL-terminated
- * string on success.  On success, set <b>sz_out</b> to the number of
- * bytes read.
+ * known ahead of time.
+ * Return NULL on failure, and a NUL-terminated string on success.
+ * On success, set <b>sz_out</b> to the number of  bytes read (not including
+ * the final NULL, which wasn't read from <b>fd</fd>).
  */
 char *
 read_file_to_str_until_eof(int fd, size_t max_bytes_to_read, size_t *sz_out)