From 4a3c922032d0ca529dfe99a2ff54d326efdcb32b Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Sat, 15 Jun 2024 17:29:39 +0200 Subject: [PATCH] doc: Update for glibc 2.38. * doc/posix-functions/strlcat.texi: New file. * doc/posix-functions/strlcpy.texi: New file. * doc/gnulib.texi: Include them. * doc/posix-headers/inttypes.texi: Update. * doc/posix-functions/*printf.texi: Update. --- ChangeLog | 9 +++++++++ doc/gnulib.texi | 4 ++++ doc/posix-functions/dprintf.texi | 2 +- doc/posix-functions/fprintf.texi | 2 +- doc/posix-functions/fwprintf.texi | 2 +- doc/posix-functions/printf.texi | 2 +- doc/posix-functions/snprintf.texi | 2 +- doc/posix-functions/sprintf.texi | 2 +- doc/posix-functions/strlcat.texi | 18 ++++++++++++++++++ doc/posix-functions/strlcpy.texi | 18 ++++++++++++++++++ doc/posix-functions/swprintf.texi | 2 +- doc/posix-functions/vdprintf.texi | 2 +- doc/posix-functions/vfprintf.texi | 2 +- doc/posix-functions/vfwprintf.texi | 2 +- doc/posix-functions/vprintf.texi | 2 +- doc/posix-functions/vsnprintf.texi | 2 +- doc/posix-functions/vsprintf.texi | 2 +- doc/posix-functions/vswprintf.texi | 2 +- doc/posix-functions/vwprintf.texi | 2 +- doc/posix-functions/wprintf.texi | 2 +- doc/posix-headers/inttypes.texi | 5 +++++ 21 files changed, 70 insertions(+), 16 deletions(-) create mode 100644 doc/posix-functions/strlcat.texi create mode 100644 doc/posix-functions/strlcpy.texi diff --git a/ChangeLog b/ChangeLog index daab372a0b..404ea7c1bf 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,12 @@ +2024-06-15 Bruno Haible + + doc: Update for glibc 2.38. + * doc/posix-functions/strlcat.texi: New file. + * doc/posix-functions/strlcpy.texi: New file. + * doc/gnulib.texi: Include them. + * doc/posix-headers/inttypes.texi: Update. + * doc/posix-functions/*printf.texi: Update. + 2024-06-15 Bruno Haible doc: Update for glibc 2.36. diff --git a/doc/gnulib.texi b/doc/gnulib.texi index 482419667c..196a332259 100644 --- a/doc/gnulib.texi +++ b/doc/gnulib.texi @@ -2380,6 +2380,8 @@ problems are not worked around by Gnulib. * strfroml:: * strftime:: * strftime_l:: +* strlcat:: +* strlcpy:: * strlen:: * strncasecmp:: * strncasecmp_l:: @@ -3720,6 +3722,8 @@ problems are not worked around by Gnulib. @include posix-functions/strfroml.texi @include posix-functions/strftime.texi @include posix-functions/strftime_l.texi +@include posix-functions/strlcat.texi +@include posix-functions/strlcpy.texi @include posix-functions/strlen.texi @include posix-functions/strncasecmp.texi @include posix-functions/strncasecmp_l.texi diff --git a/doc/posix-functions/dprintf.texi b/doc/posix-functions/dprintf.texi index 902cb28dd5..beed9c9e82 100644 --- a/doc/posix-functions/dprintf.texi +++ b/doc/posix-functions/dprintf.texi @@ -19,7 +19,7 @@ Portability problems fixed by either Gnulib module @code{dprintf-posix} or @code This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, Solaris 11.4, Cygwin 2.9.0. @item printf @code{"%f"}, @code{"%e"}, @code{"%g"} of Infinity and NaN yields an diff --git a/doc/posix-functions/fprintf.texi b/doc/posix-functions/fprintf.texi index 64c688052b..4b3f6dc798 100644 --- a/doc/posix-functions/fprintf.texi +++ b/doc/posix-functions/fprintf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/fwprintf.texi b/doc/posix-functions/fwprintf.texi index 66b190ef3e..5faf4be384 100644 --- a/doc/posix-functions/fwprintf.texi +++ b/doc/posix-functions/fwprintf.texi @@ -22,7 +22,7 @@ accommodate all Unicode characters. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function does not support the @samp{b} directive, required by ISO C23, diff --git a/doc/posix-functions/printf.texi b/doc/posix-functions/printf.texi index e99c8a6af4..0b5da3fb9f 100644 --- a/doc/posix-functions/printf.texi +++ b/doc/posix-functions/printf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/snprintf.texi b/doc/posix-functions/snprintf.texi index 07a5578fa3..7f044b11ef 100644 --- a/doc/posix-functions/snprintf.texi +++ b/doc/posix-functions/snprintf.texi @@ -31,7 +31,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/sprintf.texi b/doc/posix-functions/sprintf.texi index f432350556..ec69f4db49 100644 --- a/doc/posix-functions/sprintf.texi +++ b/doc/posix-functions/sprintf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/strlcat.texi b/doc/posix-functions/strlcat.texi new file mode 100644 index 0000000000..9000da8965 --- /dev/null +++ b/doc/posix-functions/strlcat.texi @@ -0,0 +1,18 @@ +@node strlcat +@section @code{strlcat} +@findex strlcat + +POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/<2024>/functions/strlcat.html} + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on some platforms: +glibc 2.37, AIX 7.3.1, HP-UX 11.31, mingw, MSVC 14. +@end itemize diff --git a/doc/posix-functions/strlcpy.texi b/doc/posix-functions/strlcpy.texi new file mode 100644 index 0000000000..0fe73476e9 --- /dev/null +++ b/doc/posix-functions/strlcpy.texi @@ -0,0 +1,18 @@ +@node strlcpy +@section @code{strlcpy} +@findex strlcpy + +POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/<2024>/functions/strlcpy.html} + +Gnulib module: --- + +Portability problems fixed by Gnulib: +@itemize +@end itemize + +Portability problems not fixed by Gnulib: +@itemize +@item +This function is missing on some platforms: +glibc 2.37, AIX 7.3.1, HP-UX 11.31, mingw, MSVC 14. +@end itemize diff --git a/doc/posix-functions/swprintf.texi b/doc/posix-functions/swprintf.texi index 444adb8d34..14feb10607 100644 --- a/doc/posix-functions/swprintf.texi +++ b/doc/posix-functions/swprintf.texi @@ -47,7 +47,7 @@ NetBSD 10.0. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function ignores the minimum field width in the @samp{lc} directive diff --git a/doc/posix-functions/vdprintf.texi b/doc/posix-functions/vdprintf.texi index 556aacb584..e747fd6a17 100644 --- a/doc/posix-functions/vdprintf.texi +++ b/doc/posix-functions/vdprintf.texi @@ -19,7 +19,7 @@ Portability problems fixed by either Gnulib module @code{vdprintf-posix} or @cod This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, Solaris 11.4, Cygwin 2.9.0. @item printf @code{"%f"}, @code{"%e"}, @code{"%g"} of Infinity and NaN yields an diff --git a/doc/posix-functions/vfprintf.texi b/doc/posix-functions/vfprintf.texi index 0b7b76c4ed..88f8f456ae 100644 --- a/doc/posix-functions/vfprintf.texi +++ b/doc/posix-functions/vfprintf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/vfwprintf.texi b/doc/posix-functions/vfwprintf.texi index 4a878d8092..bc1dde98fb 100644 --- a/doc/posix-functions/vfwprintf.texi +++ b/doc/posix-functions/vfwprintf.texi @@ -22,7 +22,7 @@ accommodate all Unicode characters. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function does not support the @samp{b} directive, required by ISO C23, diff --git a/doc/posix-functions/vprintf.texi b/doc/posix-functions/vprintf.texi index 32094c6c67..d2533635c9 100644 --- a/doc/posix-functions/vprintf.texi +++ b/doc/posix-functions/vprintf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/vsnprintf.texi b/doc/posix-functions/vsnprintf.texi index 0c1eb5261b..efe33733ad 100644 --- a/doc/posix-functions/vsnprintf.texi +++ b/doc/posix-functions/vsnprintf.texi @@ -28,7 +28,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/vsprintf.texi b/doc/posix-functions/vsprintf.texi index b06ef3284d..0e2c4995eb 100644 --- a/doc/posix-functions/vsprintf.texi +++ b/doc/posix-functions/vsprintf.texi @@ -16,7 +16,7 @@ AIX 5.1, HP-UX 11.23, Solaris 9, Cygwin 1.5.24, old mingw, MSVC 9. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item printf of @samp{long double} numbers is unsupported on some platforms: diff --git a/doc/posix-functions/vswprintf.texi b/doc/posix-functions/vswprintf.texi index 51a99eeb9c..ebb6ec85f0 100644 --- a/doc/posix-functions/vswprintf.texi +++ b/doc/posix-functions/vswprintf.texi @@ -24,7 +24,7 @@ On Windows, this function does not take a buffer size as second argument. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function does not support the @samp{b} directive, required by ISO C23, diff --git a/doc/posix-functions/vwprintf.texi b/doc/posix-functions/vwprintf.texi index 8203fd631b..b09c8f4280 100644 --- a/doc/posix-functions/vwprintf.texi +++ b/doc/posix-functions/vwprintf.texi @@ -25,7 +25,7 @@ accommodate all Unicode characters. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function does not support the @samp{b} directive, required by ISO C23, diff --git a/doc/posix-functions/wprintf.texi b/doc/posix-functions/wprintf.texi index d62905cafa..6444402e4a 100644 --- a/doc/posix-functions/wprintf.texi +++ b/doc/posix-functions/wprintf.texi @@ -25,7 +25,7 @@ accommodate all Unicode characters. This function does not support size specifiers as in C23 (@code{w8}, @code{w16}, @code{w32}, @code{w64}, @code{wf8}, @code{wf16}, @code{wf32}, @code{wf64}) on some platforms: -glibc, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, +glibc 2.37, musl libc, macOS 12.5, FreeBSD 13.2, NetBSD 10.0, OpenBSD 7.2, AIX 7.2, HP-UX 11, Solaris 11.4, Cygwin 2.9.0, mingw, MSVC 14. @item This function does not support the @samp{b} directive, required by ISO C23, diff --git a/doc/posix-headers/inttypes.texi b/doc/posix-headers/inttypes.texi index 2a17846498..d8ea790826 100644 --- a/doc/posix-headers/inttypes.texi +++ b/doc/posix-headers/inttypes.texi @@ -28,4 +28,9 @@ macros such as @code{PRIdMAX}. Portability problems not fixed by Gnulib: @itemize +@item +The @code{PRIb*}, @code{PRIB*}, @code{SCNb*} macros, +that were added in ISO C 23, +are missing on many platforms: +glibc 2.37 and many others. @end itemize -- 2.39.5