changeset 34514:f283d7b6f01e

docs: document recently fixed glibc printf bug Document it as a known bug, but one where we don't provide a workaround since programmers are unlikely to hit it in practice. * doc/posix-functions/fprintf.texi (fprintf): Document it. * doc/posix-functions/printf.texi (printf): Likewise. * doc/posix-functions/vfprintf.texi (vfprintf): Likewise. * doc/posix-functions/vprintf.texi (vprintf): Likewise. Signed-off-by: Eric Blake <eblake@redhat.com>
author Eric Blake <eblake@redhat.com>
date Tue, 24 May 2011 17:33:39 -0600
parents 6d4a89dd09fb
children 19c583cd7080
files ChangeLog doc/posix-functions/fprintf.texi doc/posix-functions/printf.texi doc/posix-functions/vfprintf.texi doc/posix-functions/vprintf.texi
diffstat 5 files changed, 22 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Tue May 24 17:16:00 2011 -0600
+++ b/ChangeLog	Tue May 24 17:33:39 2011 -0600
@@ -1,5 +1,11 @@
 2011-05-24  Eric Blake  <eblake@redhat.com>
 
+	docs: document recently fixed glibc printf bug
+	* doc/posix-functions/fprintf.texi (fprintf): Document it.
+	* doc/posix-functions/printf.texi (printf): Likewise.
+	* doc/posix-functions/vfprintf.texi (vfprintf): Likewise.
+	* doc/posix-functions/vprintf.texi (vprintf): Likewise.
+
 	closein-tests: convert to init.sh
 	* modules/closein-tests (Files): Add init.sh
 	* tests/test-closein.sh Use it.
--- a/doc/posix-functions/fprintf.texi	Tue May 24 17:16:00 2011 -0600
+++ b/doc/posix-functions/fprintf.texi	Tue May 24 17:33:39 2011 -0600
@@ -83,4 +83,8 @@
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Attempting to write to a read-only stream fails with @code{EOF} but
+does not set the error flag for @code{ferror} on some platforms:
+glibc 2.13.
 @end itemize
--- a/doc/posix-functions/printf.texi	Tue May 24 17:16:00 2011 -0600
+++ b/doc/posix-functions/printf.texi	Tue May 24 17:33:39 2011 -0600
@@ -83,4 +83,8 @@
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Attempting to write to a read-only stream fails with @code{EOF} but
+does not set the error flag for @code{ferror} on some platforms:
+glibc 2.13.
 @end itemize
--- a/doc/posix-functions/vfprintf.texi	Tue May 24 17:16:00 2011 -0600
+++ b/doc/posix-functions/vfprintf.texi	Tue May 24 17:33:39 2011 -0600
@@ -83,4 +83,8 @@
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Attempting to write to a read-only stream fails with @code{EOF} but
+does not set the error flag for @code{ferror} on some platforms:
+glibc 2.13.
 @end itemize
--- a/doc/posix-functions/vprintf.texi	Tue May 24 17:16:00 2011 -0600
+++ b/doc/posix-functions/vprintf.texi	Tue May 24 17:33:39 2011 -0600
@@ -83,4 +83,8 @@
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Attempting to write to a read-only stream fails with @code{EOF} but
+does not set the error flag for @code{ferror} on some platforms:
+glibc 2.13.
 @end itemize