Tweak doc of getdelim and getline declarations.

diff --git a/ChangeLog b/ChangeLog
index 13c922fbaea2bdeb076ffe671a71e3b7c2123816..035b2c9996dce239cb81130a2d3124f5fb8ad6d8 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2007-09-29  Bruno Haible  <bruno@clisp.org>
+
+       * lib/stdio_.h (getdelim, getline): Add identifiers. Doc tweak.
+
 2007-09-29  Bruno Haible  <bruno@clisp.org>
 
        * lib/xreadlink.c (xreadlink): Simplify to a wrapper around areadlink.

diff --git a/lib/stdio_.h b/lib/stdio_.h
index 76d98563779d82f9565164392ebd6bb0d35a1b0b..5264194bdf5e5621529050ec1c1322f26d9ea6d5 100644 (file)
--- a/lib/stdio_.h
+++ b/lib/stdio_.h
@@ -308,12 +308,14 @@ extern long rpl_ftell (FILE *fp);
 
 #if @GNULIB_GETDELIM@
 # if !@HAVE_DECL_GETDELIM@
-  /* Read up to (and including) a DELIMITER from FP into *LINEPTR (and
-     NUL-terminate it).  *LINEPTR is a pointer returned from malloc (or
-     NULL), pointing to *N characters of space.  It is realloc'ed as
-     necessary.  Returns the number of characters read (not including
-     the null terminator), or -1 on error or EOF.  */
-  extern ssize_t getdelim (char **, size_t *, int delim, FILE *);
+/* Read input, up to (and including) the next occurrence of DELIMITER, from
+   STREAM, store it in *LINEPTR (and NUL-terminate it).
+   *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
+   bytes of space.  It is realloc'd as necessary.
+   Return the number of bytes read and stored at *LINEPTR (not including the
+   NUL terminator), or -1 on error or EOF.  */
+extern ssize_t getdelim (char **lineptr, size_t *linesize, int delimiter,
+                        FILE *stream);
 # endif
 #elif defined GNULIB_POSIXCHECK
 # undef getdelim
@@ -329,12 +331,13 @@ extern long rpl_ftell (FILE *fp);
 #  define getline rpl_getline
 # endif
 # if !@HAVE_DECL_GETLINE@ || @REPLACE_GETLINE@
-  /* Read up to (and including) a newline from FP into *LINEPTR (and
-     NUL-terminate it).  *LINEPTR is a pointer returned from malloc (or
-     NULL), pointing to *N characters of space.  It is realloc'ed as
-     necessary.  Returns the number of characters read (not including
-     the null terminator), or -1 on error or EOF.  */
-  extern ssize_t getline (char **, size_t *, FILE *);
+/* Read a line, up to (and including) the next newline, from STREAM, store it
+   in *LINEPTR (and NUL-terminate it).
+   *LINEPTR is a pointer returned from malloc (or NULL), pointing to *LINESIZE
+   bytes of space.  It is realloc'd as necessary.
+   Return the number of bytes read and stored at *LINEPTR (not including the
+   NUL terminator), or -1 on error or EOF.  */
+extern ssize_t getline (char **lineptr, size_t *linesize, FILE *stream);
 # endif
 #elif defined GNULIB_POSIXCHECK
 # undef getline