doc: Update for glibc 2.32

[Bruno Haible]

glibc 2.32 was released two days ago. Let me update the documentation.

I'm not sure whether the problem mentioned in lchown.texi and fchmodat.texi
for glibc 2.31 is still open, or fixed, or partially fixed in glibc 2.32.
If any of you know, please feel free to update the question marks that I
left there.


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.

diff --git a/doc/glibc-functions/__libc_single_threaded.texi 
b/doc/glibc-functions/__libc_single_threaded.texi
new file mode 100644
index 0000000..45501e3
--- /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 2c95fe3..f8ba845 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 7956925..d0ea7b9 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 0000000..75b73f9
--- /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 0000000..d819c7e
--- /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 0000000..2376dac
--- /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 0000000..44e63c1
--- /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 0000000..f7fd859
--- /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 0000000..2b0820c
--- /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 8924f1e..b7cdc20 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 812e7d0..c4bf8b1 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 e582085..28bc0f6 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 fffe2f8..9581b23 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 a295f83..d0cdeb0 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 f8a4172..0dfed7b 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: