From a782d567d90dc8c8535562adc748443ce7d5f2fa Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Fri, 7 Aug 2020 23:02:21 +0200
Subject: [PATCH] doc: Update for glibc 2.32.

* doc/glibc-functions/__libc_single_threaded.texi: New file.
* doc/glibc-functions/pthread_attr_getsigmask_np.texi: New file.
* doc/glibc-functions/pthread_attr_setsigmask_np.texi: New file.
* doc/glibc-functions/sigabbrev_np.texi: New file.
* doc/glibc-functions/sigdescr_np.texi: New file.
* doc/glibc-functions/strerrordesc_np.texi: New file.
* doc/glibc-functions/strerrorname_np.texi: New file.
* doc/gnulib.texi: Include them.
(Glibc sys/single_threaded.h): New section.
* doc/pastposix-functions/h_errno.texi: Update.
* doc/posix-functions/*.texi: Likewise.
* doc/glibc-functions/*.texi: Likewise.
---
 ChangeLog                                     | 16 +++++++++++++
 .../__libc_single_threaded.texi               | 24 +++++++++++++++++++
 doc/glibc-functions/getrandom.texi            |  2 +-
 doc/glibc-functions/lchmod.texi               |  2 +-
 .../pthread_attr_getsigmask_np.texi           | 24 +++++++++++++++++++
 .../pthread_attr_setsigmask_np.texi           | 24 +++++++++++++++++++
 doc/glibc-functions/sigabbrev_np.texi         | 24 +++++++++++++++++++
 doc/glibc-functions/sigdescr_np.texi          | 24 +++++++++++++++++++
 doc/glibc-functions/strerrordesc_np.texi      | 24 +++++++++++++++++++
 doc/glibc-functions/strerrorname_np.texi      | 24 +++++++++++++++++++
 doc/glibc-functions/sysctl.texi               |  2 +-
 doc/gnulib.texi                               | 22 +++++++++++++++++
 doc/pastposix-functions/h_errno.texi          |  2 +-
 doc/posix-functions/crypt.texi                |  2 +-
 doc/posix-functions/fchmodat.texi             |  2 +-
 doc/posix-functions/setkey.texi               |  2 +-
 16 files changed, 213 insertions(+), 7 deletions(-)
 create mode 100644 doc/glibc-functions/__libc_single_threaded.texi
 create mode 100644 doc/glibc-functions/pthread_attr_getsigmask_np.texi
 create mode 100644 doc/glibc-functions/pthread_attr_setsigmask_np.texi
 create mode 100644 doc/glibc-functions/sigabbrev_np.texi
 create mode 100644 doc/glibc-functions/sigdescr_np.texi
 create mode 100644 doc/glibc-functions/strerrordesc_np.texi
 create mode 100644 doc/glibc-functions/strerrorname_np.texi

diff --git a/ChangeLog b/ChangeLog
index f568b2bdd1..2d63ae286f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2020-08-07  Bruno Haible  <bruno@clisp.org>
+
+	doc: Update for glibc 2.32.
+	* doc/glibc-functions/__libc_single_threaded.texi: New file.
+	* doc/glibc-functions/pthread_attr_getsigmask_np.texi: New file.
+	* doc/glibc-functions/pthread_attr_setsigmask_np.texi: New file.
+	* doc/glibc-functions/sigabbrev_np.texi: New file.
+	* doc/glibc-functions/sigdescr_np.texi: New file.
+	* doc/glibc-functions/strerrordesc_np.texi: New file.
+	* doc/glibc-functions/strerrorname_np.texi: New file.
+	* doc/gnulib.texi: Include them.
+	(Glibc sys/single_threaded.h): New section.
+	* doc/pastposix-functions/h_errno.texi: Update.
+	* doc/posix-functions/*.texi: Likewise.
+	* doc/glibc-functions/*.texi: Likewise.
+
 2020-08-07  Bruno Haible  <bruno@clisp.org>
 
 	alloca: No need to compile alloca.c with clang.
diff --git a/doc/glibc-functions/__libc_single_threaded.texi b/doc/glibc-functions/__libc_single_threaded.texi
new file mode 100644
index 0000000000..45501e323f
--- /dev/null
+++ b/doc/glibc-functions/__libc_single_threaded.texi
@@ -0,0 +1,24 @@
+@node __libc_single_threaded
+@subsection @code{__libc_single_threaded}
+@findex __libc_single_threaded
+
+Documentation:@*
+@ifinfo
+@ref{Single Threaded,,Detecting Single-Threaded Execution,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Single_002dThreaded.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This variable is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/getrandom.texi b/doc/glibc-functions/getrandom.texi
index 2c95fe3561..f8ba845428 100644
--- a/doc/glibc-functions/getrandom.texi
+++ b/doc/glibc-functions/getrandom.texi
@@ -31,7 +31,7 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 The @code{GRND_INSECURE} flag is missing on some platforms:
-glibc 2.31, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5,
+glibc 2.32, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5,
 Minix 3.3, Haiku.
 
 @item
diff --git a/doc/glibc-functions/lchmod.texi b/doc/glibc-functions/lchmod.texi
index 79569258e1..d0ea7b995f 100644
--- a/doc/glibc-functions/lchmod.texi
+++ b/doc/glibc-functions/lchmod.texi
@@ -15,7 +15,7 @@ HP-UX 11.31.
 @item
 This function always fails with @code{errno} set to @code{ENOSYS},
 even when the file is not a symbolic link:
-GNU/Linux with glibc 2.31.
+GNU/Linux with glibc 2.31 (or newer?).
 @end itemize
 
 Portability problems not fixed by Gnulib:
diff --git a/doc/glibc-functions/pthread_attr_getsigmask_np.texi b/doc/glibc-functions/pthread_attr_getsigmask_np.texi
new file mode 100644
index 0000000000..75b73f9b42
--- /dev/null
+++ b/doc/glibc-functions/pthread_attr_getsigmask_np.texi
@@ -0,0 +1,24 @@
+@node pthread_attr_getsigmask_np
+@subsection @code{pthread_attr_getsigmask_np}
+@findex pthread_attr_getsigmask_np
+
+Documentation:@*
+@ifinfo
+@ref{Initial Thread Signal Mask,,Controlling the Initial Signal Mask of a New Thread,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Initial-Thread-Signal-Mask.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/pthread_attr_setsigmask_np.texi b/doc/glibc-functions/pthread_attr_setsigmask_np.texi
new file mode 100644
index 0000000000..d819c7ea72
--- /dev/null
+++ b/doc/glibc-functions/pthread_attr_setsigmask_np.texi
@@ -0,0 +1,24 @@
+@node pthread_attr_setsigmask_np
+@subsection @code{pthread_attr_setsigmask_np}
+@findex pthread_attr_setsigmask_np
+
+Documentation:@*
+@ifinfo
+@ref{Initial Thread Signal Mask,,Controlling the Initial Signal Mask of a New Thread,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Initial-Thread-Signal-Mask.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/sigabbrev_np.texi b/doc/glibc-functions/sigabbrev_np.texi
new file mode 100644
index 0000000000..2376dac436
--- /dev/null
+++ b/doc/glibc-functions/sigabbrev_np.texi
@@ -0,0 +1,24 @@
+@node sigabbrev_np
+@subsection @code{sigabbrev_np}
+@findex sigabbrev_np
+
+Documentation:@*
+@ifinfo
+@ref{Signal Messages,,Signal Messages,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Signal-Messages.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/sigdescr_np.texi b/doc/glibc-functions/sigdescr_np.texi
new file mode 100644
index 0000000000..44e63c1168
--- /dev/null
+++ b/doc/glibc-functions/sigdescr_np.texi
@@ -0,0 +1,24 @@
+@node sigdescr_np
+@subsection @code{sigdescr_np}
+@findex sigdescr_np
+
+Documentation:@*
+@ifinfo
+@ref{Signal Messages,,Signal Messages,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Signal-Messages.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/strerrordesc_np.texi b/doc/glibc-functions/strerrordesc_np.texi
new file mode 100644
index 0000000000..f7fd85971e
--- /dev/null
+++ b/doc/glibc-functions/strerrordesc_np.texi
@@ -0,0 +1,24 @@
+@node strerrordesc_np
+@subsection @code{strerrordesc_np}
+@findex strerrordesc_np
+
+Documentation:@*
+@ifinfo
+@ref{Error Messages,,Error Messages,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Error-Messages.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/strerrorname_np.texi b/doc/glibc-functions/strerrorname_np.texi
new file mode 100644
index 0000000000..2b0820c367
--- /dev/null
+++ b/doc/glibc-functions/strerrorname_np.texi
@@ -0,0 +1,24 @@
+@node strerrorname_np
+@subsection @code{strerrorname_np}
+@findex strerrorname_np
+
+Documentation:@*
+@ifinfo
+@ref{Error Messages,,Error Messages,libc}.
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Error-Messages.html}.
+@end ifnotinfo
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on all non-glibc platforms:
+glibc 2.31, Mac OS X 10.13, FreeBSD 6.4, NetBSD 9.0, OpenBSD 3.8, Minix 3.1.8, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/sysctl.texi b/doc/glibc-functions/sysctl.texi
index 8924f1e9ab..b7cdc206de 100644
--- a/doc/glibc-functions/sysctl.texi
+++ b/doc/glibc-functions/sysctl.texi
@@ -25,5 +25,5 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.32, Minix 3.1.8, AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
 @end itemize
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 812e7d063f..c4bf8b1c89 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -3829,6 +3829,7 @@ This list of functions is sorted according to the header that declares them.
 * Glibc sys/sem.h::
 * Glibc sys/sendfile.h::
 * Glibc sys/signalfd.h::
+* Glibc sys/single_threaded.h::
 * Glibc sys/socket.h::
 * Glibc sys/stat.h::
 * Glibc sys/statfs.h::
@@ -4743,6 +4744,8 @@ This list of functions is sorted according to the header that declares them.
 @menu
 * pthread_attr_getaffinity_np::
 * pthread_attr_setaffinity_np::
+* pthread_attr_getsigmask_np::
+* pthread_attr_setsigmask_np::
 * pthread_clockjoin_np::
 * pthread_cond_clockwait::
 * pthread_getaffinity_np::
@@ -4769,6 +4772,8 @@ This list of functions is sorted according to the header that declares them.
 
 @include glibc-functions/pthread_attr_getaffinity_np.texi
 @include glibc-functions/pthread_attr_setaffinity_np.texi
+@include glibc-functions/pthread_attr_getsigmask_np.texi
+@include glibc-functions/pthread_attr_setsigmask_np.texi
 @include glibc-functions/pthread_clockjoin_np.texi
 @include glibc-functions/pthread_cond_clockwait.texi
 @include glibc-functions/pthread_getaffinity_np.texi
@@ -5781,8 +5786,12 @@ This list of functions is sorted according to the header that declares them.
 * mempcpy::
 * memrchr::
 * rawmemchr::
+* sigabbrev_np::
+* sigdescr_np::
 * strcasestr::
 * strchrnul::
+* strerrordesc_np::
+* strerrorname_np::
 * strfry::
 * strsep::
 * strverscmp::
@@ -5796,8 +5805,12 @@ This list of functions is sorted according to the header that declares them.
 @include glibc-functions/mempcpy.texi
 @include glibc-functions/memrchr.texi
 @include glibc-functions/rawmemchr.texi
+@include glibc-functions/sigabbrev_np.texi
+@include glibc-functions/sigdescr_np.texi
 @include glibc-functions/strcasestr.texi
 @include glibc-functions/strchrnul.texi
+@include glibc-functions/strerrordesc_np.texi
+@include glibc-functions/strerrorname_np.texi
 @include glibc-functions/strfry.texi
 @include glibc-functions/strsep.texi
 @include glibc-functions/strverscmp.texi
@@ -6100,6 +6113,15 @@ This list of functions is sorted according to the header that declares them.
 
 @include glibc-functions/signalfd.texi
 
+@node Glibc sys/single_threaded.h
+@section Glibc @code{<sys/single_threaded.h>}
+
+@menu
+* __libc_single_threaded::
+@end menu
+
+@include glibc-functions/__libc_single_threaded.texi
+
 @node Glibc sys/socket.h
 @section Glibc Extensions to @code{<sys/socket.h>}
 
diff --git a/doc/pastposix-functions/h_errno.texi b/doc/pastposix-functions/h_errno.texi
index e5820850ed..28bc0f6e15 100644
--- a/doc/pastposix-functions/h_errno.texi
+++ b/doc/pastposix-functions/h_errno.texi
@@ -14,5 +14,5 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-glibc 2.31, IRIX 6.5, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.32, IRIX 6.5, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
 @end itemize
diff --git a/doc/posix-functions/crypt.texi b/doc/posix-functions/crypt.texi
index fffe2f8c84..9581b23acc 100644
--- a/doc/posix-functions/crypt.texi
+++ b/doc/posix-functions/crypt.texi
@@ -14,7 +14,7 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-glibc 2.31, FreeBSD 6.0, NetBSD 5.0, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.32, FreeBSD 6.0, NetBSD 5.0, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
 @item
 This function is not declared in @code{<unistd.h>}
 (without @code{-D_GNU_SOURCE}) on some platforms:
diff --git a/doc/posix-functions/fchmodat.texi b/doc/posix-functions/fchmodat.texi
index a295f83853..d0cdeb08f8 100644
--- a/doc/posix-functions/fchmodat.texi
+++ b/doc/posix-functions/fchmodat.texi
@@ -17,7 +17,7 @@ But the replacement function is not safe to be used in libraries and is not mult
 When given the @code{AT_SYMLINK_NOFOLLOW} flag,
 this function fails with @code{errno} set to @code{ENOTSUP},
 even when the file is not a symbolic link:
-GNU/Linux with glibc 2.31, Cygwin 2.9.
+GNU/Linux with glibc 2.31 (or newer?), Cygwin 2.9.
 @end itemize
 
 Portability problems not fixed by Gnulib:
diff --git a/doc/posix-functions/setkey.texi b/doc/posix-functions/setkey.texi
index f8a4172d0b..0dfed7b9b1 100644
--- a/doc/posix-functions/setkey.texi
+++ b/doc/posix-functions/setkey.texi
@@ -14,7 +14,7 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-glibc 2.31, NetBSD 5.0, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.32, NetBSD 5.0, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
 @item
 This function is not declared in @code{<stdlib.h>}
 (without @code{-D_GNU_SOURCE}) on some platforms:
-- 
2.39.5