From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sun, 23 Jun 2019 22:36:49 +0000 (-0700)
Subject: Document setvbuf _IOLBF problem
X-Git-Tag: v1.0~4828
X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=232ba923073d6f1bebb6ae1baaa7feb68b90619a;p=gnulib.git

Document setvbuf _IOLBF problem

* doc/posix-functions/setvbuf.texi (setvbuf):
Document MS-Windows portability problem with _IOLBF.
---

diff --git a/ChangeLog b/ChangeLog
index cf0bbb396b..a25be21d2f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2019-06-23  Paul Eggert  <eggert@cs.ucla.edu>
 
+	Document setvbuf _IOLBF problem
+	* doc/posix-functions/setvbuf.texi (setvbuf):
+	Document MS-Windows portability problem with _IOLBF.
+
 	Document lseek SEEK_DATA/SEEK_HOLE
 	* doc/posix-functions/lseek.texi (lseek):
 	Document some systems that do not support SEEK_DATA and SEEK_HOLE.
diff --git a/doc/posix-functions/setvbuf.texi b/doc/posix-functions/setvbuf.texi
index ec3252c385..247f75253d 100644
--- a/doc/posix-functions/setvbuf.texi
+++ b/doc/posix-functions/setvbuf.texi
@@ -15,4 +15,8 @@ Portability problems not fixed by Gnulib:
 @item
 On Windows platforms (excluding Cygwin), this function does not set @code{errno}
 upon failure.
+@item
+On Windows platforms (excluding Cygwin), @code{_IOLBF} (line-buffering)
+is treated as if it were @code{_IOFBF} (full buffering),
+possibly with a warning generated.
 @end itemize