From: Bruno Haible <bruno@clisp.org>
Date: Mon, 28 May 2007 13:55:57 +0000 (+0000)
Subject: More comments.
X-Git-Tag: cvs-readonly~339
X-Git-Url: http://erislabs.org.uk/gitweb/?a=commitdiff_plain;h=1bd3ce48983c66caa6f09948826f741f38dc7af5;p=gnulib.git

More comments.
---

diff --git a/ChangeLog b/ChangeLog
index 807c5726e..b1eabf737 100644
--- 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 2b920fcd2..a8290ac3a 100644
--- 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