More comments.

diff --git a/ChangeLog b/ChangeLog
index 807c572..b1eabf7 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2007-05-28  Bruno Haible  <bruno@clisp.org>
 
+       * lib/stdio_.h (fflush): More comments.
+
+2007-05-28  Bruno Haible  <bruno@clisp.org>
+
        * m4/lseek.m4 (gl_FUNC_LSEEK): When not cross-compiling, perform a real
        runtime test.
 

diff --git a/lib/stdio_.h b/lib/stdio_.h
index 2b920fc..a8290ac 100644 (file)
--- a/lib/stdio_.h
+++ b/lib/stdio_.h
@@ -270,7 +270,11 @@ extern off_t ftello (FILE *fp);
 # if @REPLACE_FFLUSH@
 #  define fflush rpl_fflush
   /* Flush all pending data on STREAM according to POSIX rules.  Both
-     output and seekable input streams are supported.  */
+     output and seekable input streams are supported.
+     Note! LOSS OF DATA can occur if fflush is applied on an input stream
+     that is _not_seekable_ or on an update stream that is _not_seekable_
+     and in which the most recent operation was input.  Seekability can
+     be tested with lseek(fileno(fp),0,SEEK_CUR).  */
   extern int fflush (FILE *gl_stream);
 # endif
 #elif defined GNULIB_POSIXCHECK