X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fprintf.texi;h=8fc8cb092204e8ead12c0b379f9bf6be292ad0d2;hb=ce05829e2da40a92966f0e3d78d1b40c6f1e85b5;hp=56bce47f80e5ce6cd25ff45fe70c4417411a0577;hpb=542406c922c11cea5a7fd3c7268e5be3e9c8928b;p=gnulib.git diff --git a/doc/posix-functions/printf.texi b/doc/posix-functions/printf.texi index 56bce47f8..8fc8cb092 100644 --- a/doc/posix-functions/printf.texi +++ b/doc/posix-functions/printf.texi @@ -2,9 +2,9 @@ @section @code{printf} @findex printf -POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/printf.html} +POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/printf.html} -Gnulib module: printf-posix or stdio, sigpipe +Gnulib module: printf-posix or stdio, nonblocking, sigpipe Portability problems fixed by Gnulib module @code{printf-posix}: @itemize @@ -18,17 +18,24 @@ mingw, BeOS. @item printf @code{"%f"}, @code{"%e"}, @code{"%g"} of Infinity and NaN yields an incorrect result on some platforms: -AIX 5.2, OSF/1 5.1, Solaris 10, mingw. +AIX 5.2, OSF/1 5.1, Solaris 11 2010-11, mingw. @item This function does not support the @samp{a} and @samp{A} directives on some platforms: -glibc-2.3.6, MacOS X 10.3, NetBSD 3.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, -IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, BeOS. +glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, +IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin 1.5.x, mingw, BeOS. @item This function does not support the @samp{F} directive on some platforms: NetBSD 3.0, AIX 5.1, HP-UX 11.23, IRIX 6.5, OSF/1 5.1, Solaris 9, Cygwin 1.5.x, mingw, BeOS. @item +This function does not support the @samp{ls} directive on some platforms: +OpenBSD 4.0, IRIX 6.5, Solaris 2.6, Cygwin 1.5.x, Haiku. +@item +This function does not support precisions in the @samp{ls} directive correctly +on some platforms: +Solaris 11 2010-11. +@item This function does not support format directives that access arguments in an arbitrary order, such as @code{"%2$s"}, on some platforms: NetBSD 3.0, mingw, BeOS. @@ -42,14 +49,28 @@ HP-UX 10.20. @item printf @code{"%010f"} of NaN and Infinity yields an incorrect result (padded with zeroes) on some platforms: -MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, AIX 5.2, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw. +MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, AIX 5.2, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin 1.5.x, mingw. @item This function does not support precisions larger than 512 or 1024 in integer, floating-point and pointer output on some platforms: -mingw, BeOS. +Solaris 10/x86, mingw, BeOS. +@item +This function mishandles large floating point precisions +(for example, formatting 1.0 with @samp{"%.511f"}) +on some platforms: +Solaris 10. @item This function can crash in out-of-memory conditions on some platforms: -MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0. +MacOS X 10.3, FreeBSD 6.0, NetBSD 5.0. +@end itemize + +Portability problems fixed by Gnulib module @code{stdio} or @code{printf-posix}, together with module @code{nonblocking}: +@itemize +@item +When writing to a non-blocking pipe whose buffer is full, this function fails +with @code{errno} being set to @code{ENOSPC} instead of @code{EAGAIN} on some +platforms: +mingw. @end itemize Portability problems fixed by Gnulib module @code{stdio} or @code{printf-posix}, together with module @code{sigpipe}: @@ -62,4 +83,8 @@ mingw. 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