snprintf: guarantee %1$d, for libintl

[pspp] / doc / posix-functions / strerror.texi

diff --git a/doc/posix-functions/strerror.texi b/doc/posix-functions/strerror.texi
index 84d92c3f1441fd36241534862e8dc3a2c0671f92..21fc990659a32e3ffde1a3ee4da7b7b6a7e7e663 100644 (file)
--- a/doc/posix-functions/strerror.texi
+++ b/doc/posix-functions/strerror.texi
@@ -13,9 +13,19 @@ This function does not support the error values that are specified by POSIX
 but not defined by the system, on some platforms:
 OpenBSD 4.0, OSF/1 5.1, NonStop Kernel, Cygwin 1.5.x, mingw.
 @item
+This function reports failure for @code{strerror(0)} (by setting
+@code{errno} or using a string similar to out-of-range values),
+although POSIX requires this to leave @code{errno} unchanged and
+report success, on some platforms:
+FreeBSD 8.2, OpenBSD 4.7, MacOS X 10.5.
+@item
 This function fails to return a string for out-of-range integers on
 some platforms:
-Solaris 8.
+HP-UX 11, IRIX 6.5, Solaris 8.
+(Some return NULL which is a POSIX violation, others return the empty
+string which is valid but not as useful); this can still cause bugs
+because most programs call @code{strerror} without setting and testing
+@code{errno}.)
 @end itemize
 
 Portability problems not fixed by Gnulib: