doc: document Solaris printf bug with large float precisions

* doc/posix-functions/dprintf.texi (dprintf):
* doc/posix-functions/fprintf.texi (fprintf):
* doc/posix-functions/printf.texi (printf):
* doc/posix-functions/snprintf.texi (snprintf):
* doc/posix-functions/sprintf.texi (sprintf):
* doc/posix-functions/vdprintf.texi (vdprintf):
* doc/posix-functions/vfprintf.texi (vfprintf):
* doc/posix-functions/vprintf.texi (vprintf):
* doc/posix-functions/vsnprintf.texi (vsnprintf):
* doc/posix-functions/vsprintf.texi (vsprintf):
Mention that these functions mishandle large floating point
precisions on Solaris 10.  The same bug is also present in Solaris
8, and I assume earlier.  This causes "cd gnulib-tests; make
check" to fail on Solaris 8 (and I assume, later) when building
the latest coreutils, in test-vasprintf-posix's call to
my_asprintf (&result, "%.4000f %d", 1.0, 99).  I have not checked
the wide flavors (e.g., wprintf) so this patch just updates the
documentation for the narrow ones.

diff --git a/ChangeLog b/ChangeLog
index 2dc4aebf8a1c1a71304bf16889d4a76b24277473..276a1cadeab0ac841ae504b186e97dfbc239048c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,25 @@
 2010-12-22  Paul Eggert  <eggert@cs.ucla.edu>
 
+       doc: document Solaris printf bug with large float precisions
+       * doc/posix-functions/dprintf.texi (dprintf):
+       * doc/posix-functions/fprintf.texi (fprintf):
+       * doc/posix-functions/printf.texi (printf):
+       * doc/posix-functions/snprintf.texi (snprintf):
+       * doc/posix-functions/sprintf.texi (sprintf):
+       * doc/posix-functions/vdprintf.texi (vdprintf):
+       * doc/posix-functions/vfprintf.texi (vfprintf):
+       * doc/posix-functions/vprintf.texi (vprintf):
+       * doc/posix-functions/vsnprintf.texi (vsnprintf):
+       * doc/posix-functions/vsprintf.texi (vsprintf):
+       Mention that these functions mishandle large floating point
+       precisions on Solaris 10.  The same bug is also present in Solaris
+       8, and I assume earlier.  This causes "cd gnulib-tests; make
+       check" to fail on Solaris 8 (and I assume, later) when building
+       the latest coreutils, in test-vasprintf-posix's call to
+       my_asprintf (&result, "%.4000f %d", 1.0, 99).  I have not checked
+       the wide flavors (e.g., wprintf) so this patch just updates the
+       documentation for the narrow ones.
+
        test-posixtm.c: add two tests
        * tests/test-posixtm.c: Add two tests, to highlight the
        bug in Solaris 10 (and earlier) localtime.  Gnulib doesn't work

diff --git a/doc/posix-functions/dprintf.texi b/doc/posix-functions/dprintf.texi
index dc39022926097cbb2c4816b50c1632ef4927d189..3f9f54b624d968c8d66f44363208c34298b37604 100644 (file)
--- a/doc/posix-functions/dprintf.texi
+++ b/doc/posix-functions/dprintf.texi
@@ -24,4 +24,9 @@ glibc-2.3.6.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/fprintf.texi b/doc/posix-functions/fprintf.texi
index f394e8831518fb0010e9140ea41d68153525a65f..116d20e13f94e333d78a5769360cf1669cd346fe 100644 (file)
--- a/doc/posix-functions/fprintf.texi
+++ b/doc/posix-functions/fprintf.texi
@@ -69,4 +69,9 @@ mingw.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/printf.texi b/doc/posix-functions/printf.texi
index b380ebc5bb3fbf338fecc335e04883153691dec7..fb894d6f45dab5ce45cef2b1dc4b71aaa56c9dbe 100644 (file)
--- a/doc/posix-functions/printf.texi
+++ b/doc/posix-functions/printf.texi
@@ -69,4 +69,9 @@ mingw.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/snprintf.texi b/doc/posix-functions/snprintf.texi
index 9e8f5ada965ea5808c990e5a1eb2ec0976a9e503..23fa5e7f4fac3795d7955ecf8ff177be87abb8b3 100644 (file)
--- a/doc/posix-functions/snprintf.texi
+++ b/doc/posix-functions/snprintf.texi
@@ -89,4 +89,9 @@ OSF/1 5.1.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/sprintf.texi b/doc/posix-functions/sprintf.texi
index 5ebd16f6011e719bedc80a5623d56bc6509d1901..cce9627625fffc1f6de8e5730a6d55a19c475124 100644 (file)
--- a/doc/posix-functions/sprintf.texi
+++ b/doc/posix-functions/sprintf.texi
@@ -61,4 +61,9 @@ MacOS X 10.3, FreeBSD 6.0, NetBSD 5.0.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/vdprintf.texi b/doc/posix-functions/vdprintf.texi
index 20a6ef75c550101be89f2f682c26cfa54e7aa559..3fa9b737a96267455950d81fe3a9c9cb9ea2fdda 100644 (file)
--- a/doc/posix-functions/vdprintf.texi
+++ b/doc/posix-functions/vdprintf.texi
@@ -42,4 +42,9 @@ BeOS.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/vfprintf.texi b/doc/posix-functions/vfprintf.texi
index 179e67a6b95e940f2faf18c42c5d2213d63520ee..7f41c0d5522ab74e958a8ca264631fa19545a613 100644 (file)
--- a/doc/posix-functions/vfprintf.texi
+++ b/doc/posix-functions/vfprintf.texi
@@ -69,4 +69,9 @@ mingw.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/vprintf.texi b/doc/posix-functions/vprintf.texi
index ac533888b8ffef4afa02d0435769f65feb31a7f0..213461c9f36301bdef7b32c5405501c2aaa1b8e8 100644 (file)
--- a/doc/posix-functions/vprintf.texi
+++ b/doc/posix-functions/vprintf.texi
@@ -69,4 +69,9 @@ mingw.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/vsnprintf.texi b/doc/posix-functions/vsnprintf.texi
index 9784f6d63608793c51a7bc6819e17d5150bcb4ef..8f6d90376eb5ac9b827c814315ac676c2b168b32 100644 (file)
--- a/doc/posix-functions/vsnprintf.texi
+++ b/doc/posix-functions/vsnprintf.texi
@@ -89,4 +89,9 @@ HP-UX 11, OSF/1 5.1.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize

diff --git a/doc/posix-functions/vsprintf.texi b/doc/posix-functions/vsprintf.texi
index 82c79492a56ee2f9dbea10ded33f00e533ad7d39..317853885a45c632935eba9e39c3dfb02653fd30 100644 (file)
--- a/doc/posix-functions/vsprintf.texi
+++ b/doc/posix-functions/vsprintf.texi
@@ -61,4 +61,9 @@ MacOS X 10.3, FreeBSD 6.0, NetBSD 5.0.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+This function mishandles large floating point precisions
+(for example, formatting 1.0 with @samp{"%.511f"})
+on some platforms:
+Solaris 10.
 @end itemize