From d06b2e55868df5173483836d515338f54d471508 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Sun, 22 Apr 2012 16:43:29 +0200 Subject: [PATCH] doc: Mention reason for replacement on glibc/Linux systems. * doc/posix-functions/dprintf.texi: Mention the problem with special 'long double' values. * doc/posix-functions/fprintf.texi: Likewise. * doc/posix-functions/printf.texi: Likewise. * doc/posix-functions/snprintf.texi: Likewise. * doc/posix-functions/sprintf.texi: Likewise. * doc/posix-functions/vdprintf.texi: Likewise. * doc/posix-functions/vfprintf.texi: Likewise. * doc/posix-functions/vprintf.texi: Likewise. * doc/posix-functions/vsnprintf.texi: Likewise. * doc/posix-functions/vsprintf.texi: Likewise. * doc/posix-functions/fcntl.texi: Add glibc/Linux to the list of platforms with F_DUPFD_CLOEXEC problems. * doc/posix-functions/glob.texi: Mention which platforms are affected by the problem with symbolic links. * doc/posix-functions/linkat.texi: Mention the problem with AT_SYMLINK_FOLLOW on Linux. --- ChangeLog | 21 +++++++++++++++++++++ doc/posix-functions/dprintf.texi | 4 ++++ doc/posix-functions/fcntl.texi | 1 + doc/posix-functions/fprintf.texi | 4 ++++ doc/posix-functions/glob.texi | 5 +++-- doc/posix-functions/linkat.texi | 3 +++ doc/posix-functions/printf.texi | 4 ++++ doc/posix-functions/snprintf.texi | 4 ++++ doc/posix-functions/sprintf.texi | 4 ++++ doc/posix-functions/vdprintf.texi | 4 ++++ doc/posix-functions/vfprintf.texi | 4 ++++ doc/posix-functions/vprintf.texi | 4 ++++ doc/posix-functions/vsnprintf.texi | 4 ++++ doc/posix-functions/vsprintf.texi | 4 ++++ 14 files changed, 68 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index 3379a7e32..567ec3065 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,26 @@ 2012-04-22 Bruno Haible + doc: Mention reason for replacement on glibc/Linux systems. + * doc/posix-functions/dprintf.texi: Mention the problem with special + 'long double' values. + * doc/posix-functions/fprintf.texi: Likewise. + * doc/posix-functions/printf.texi: Likewise. + * doc/posix-functions/snprintf.texi: Likewise. + * doc/posix-functions/sprintf.texi: Likewise. + * doc/posix-functions/vdprintf.texi: Likewise. + * doc/posix-functions/vfprintf.texi: Likewise. + * doc/posix-functions/vprintf.texi: Likewise. + * doc/posix-functions/vsnprintf.texi: Likewise. + * doc/posix-functions/vsprintf.texi: Likewise. + * doc/posix-functions/fcntl.texi: Add glibc/Linux to the list of + platforms with F_DUPFD_CLOEXEC problems. + * doc/posix-functions/glob.texi: Mention which platforms are affected + by the problem with symbolic links. + * doc/posix-functions/linkat.texi: Mention the problem with + AT_SYMLINK_FOLLOW on Linux. + +2012-04-22 Bruno Haible + pwrite: Don't replace on all platforms. * m4/pwrite.m4 (gl_FUNC_PWRITE): Fix syntax error in test program. diff --git a/doc/posix-functions/dprintf.texi b/doc/posix-functions/dprintf.texi index 83c95cfb2..b4c055509 100644 --- a/doc/posix-functions/dprintf.texi +++ b/doc/posix-functions/dprintf.texi @@ -17,6 +17,10 @@ IRIX 6.5, OSF/1 5.1, Solaris 11 2011-11, Cygwin 1.5.x, mingw, MSVC 9, Interix 3. Portability problems fixed by Gnulib module @code{dprintf-posix}: @itemize @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6. diff --git a/doc/posix-functions/fcntl.texi b/doc/posix-functions/fcntl.texi index 8278dc245..34e21ce29 100644 --- a/doc/posix-functions/fcntl.texi +++ b/doc/posix-functions/fcntl.texi @@ -15,6 +15,7 @@ mingw, MSVC 9. @item This function does not support @code{F_DUPFD_CLOEXEC} on some platforms: +glibc with Linux kernels before 2.6.24, MacOS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11, Cygwin 1.7.1, Interix 3.5, BeOS. diff --git a/doc/posix-functions/fprintf.texi b/doc/posix-functions/fprintf.texi index 40525c018..9a01ddbe9 100644 --- a/doc/posix-functions/fprintf.texi +++ b/doc/posix-functions/fprintf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/glob.texi b/doc/posix-functions/glob.texi index 0b98883e5..21102f74c 100644 --- a/doc/posix-functions/glob.texi +++ b/doc/posix-functions/glob.texi @@ -12,8 +12,9 @@ Portability problems fixed by Gnulib: This function is missing on some platforms: IRIX 5.3, mingw, MSVC 9, BeOS. @item -This function may list symbolic links to nonexistent files among the results, -on some platforms. +This function does not list symbolic links to nonexistent files among the results, +on some platforms: +glibc 2.14, AIX 7.1, HP-UX 11, Solaris 11 2011-11. @item On platforms where @code{off_t} is a 32-bit type, this function may not work correctly on huge directories larger than 2 GB. diff --git a/doc/posix-functions/linkat.texi b/doc/posix-functions/linkat.texi index 902dec1ed..e34014800 100644 --- a/doc/posix-functions/linkat.texi +++ b/doc/posix-functions/linkat.texi @@ -17,6 +17,9 @@ But the replacement function is not safe to be used in libraries and is not mult This function fails to reject trailing slashes on non-directories on some platforms: AIX 7.1, Solaris 11 2011-11. +@item +This functions does not support @code{AT_SYMLINK_FOLLOW} on some platforms: +Linux kernel 2.6.17. @end itemize Portability problems not fixed by Gnulib: diff --git a/doc/posix-functions/printf.texi b/doc/posix-functions/printf.texi index d704ac329..cd517fdbf 100644 --- a/doc/posix-functions/printf.texi +++ b/doc/posix-functions/printf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/snprintf.texi b/doc/posix-functions/snprintf.texi index c6e4a0039..e54d9f89b 100644 --- a/doc/posix-functions/snprintf.texi +++ b/doc/posix-functions/snprintf.texi @@ -39,6 +39,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/sprintf.texi b/doc/posix-functions/sprintf.texi index 639241708..096eab901 100644 --- a/doc/posix-functions/sprintf.texi +++ b/doc/posix-functions/sprintf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/vdprintf.texi b/doc/posix-functions/vdprintf.texi index 21a271446..6e09287dd 100644 --- a/doc/posix-functions/vdprintf.texi +++ b/doc/posix-functions/vdprintf.texi @@ -24,6 +24,10 @@ BeOS. printf of @samp{long double} numbers is unsupported on some platforms: BeOS. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, BeOS. diff --git a/doc/posix-functions/vfprintf.texi b/doc/posix-functions/vfprintf.texi index 1a889f310..e7759ebe6 100644 --- a/doc/posix-functions/vfprintf.texi +++ b/doc/posix-functions/vfprintf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/vprintf.texi b/doc/posix-functions/vprintf.texi index d14505b0f..22d773909 100644 --- a/doc/posix-functions/vprintf.texi +++ b/doc/posix-functions/vprintf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/vsnprintf.texi b/doc/posix-functions/vsnprintf.texi index 7312734a9..8f93fc53c 100644 --- a/doc/posix-functions/vsnprintf.texi +++ b/doc/posix-functions/vsnprintf.texi @@ -39,6 +39,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, diff --git a/doc/posix-functions/vsprintf.texi b/doc/posix-functions/vsprintf.texi index a8959071d..f45ce8924 100644 --- a/doc/posix-functions/vsprintf.texi +++ b/doc/posix-functions/vsprintf.texi @@ -20,6 +20,10 @@ 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 11 2011-11, mingw, MSVC 9. @item +printf of @samp{long double} numbers outside the IEEE 754 range produces +no meaningful results on some platforms: +glibc and others, on x86, x86_64, IA-64 CPUs. +@item This function does not support the @samp{a} and @samp{A} directives on some platforms: glibc-2.3.6, MacOS X 10.5, NetBSD 5.0, OpenBSD 4.0, AIX 5.2, HP-UX 11, -- 2.11.0