More comments.

diff --git a/ChangeLog b/ChangeLog
index 807c5726e47a01de418dce4df21297770dfd3873..b1eabf737a078b1b609c8f903fa04a8a06fdc5e1 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+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

diff --git a/lib/stdio_.h b/lib/stdio_.h
index 2b920fcd2e5db8472efd96d13407e4f69afee77c..a8290ac3a39c4bf10f4dd19f34504201492daef6 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