doc: update for glibc 2.30

[Bruno Haible]

After the big doc update from 2019-06-10, I don't want the gnulib documentation
again lag behind glibc by 5 years.


2019-09-07  Bruno Haible  <address@hidden>

        doc: Update for glibc 2.30.
        * doc/glibc-functions/gettid.texi: New file.
        * doc/glibc-functions/pthread_cond_clockwait.texi: New file.
        * doc/glibc-functions/pthread_mutex_clocklock.texi: New file.
        * doc/glibc-functions/pthread_rwlock_clockrdlock.texi: New file.
        * doc/glibc-functions/pthread_rwlock_clockwrlock.texi: New file.
        * doc/glibc-functions/sem_clockwait.texi: New file.
        * doc/glibc-functions/tgkill.texi: New file.
        * doc/glibc-functions/twalk_r.texi: New file.
        * doc/gnulib.texi: Include them.
        (Glibc semaphore.h): New section.
        * doc/pastposix-functions/h_errno.texi: Update.
        * doc/posix-functions/*.texi: Likewise.

diff --git a/doc/glibc-functions/gettid.texi b/doc/glibc-functions/gettid.texi
new file mode 100644
index 0000000..dae3848
--- /dev/null
+++ b/doc/glibc-functions/gettid.texi
@@ -0,0 +1,30 @@
+@node gettid
+@subsection @code{gettid}
+@findex gettid
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Process Identification,,Process Identification,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Process-Identification.html},
+@end ifnotinfo
+@item
+@uref{https://www.kernel.org/doc/man-pages/online/pages/man2/gettid.2.html,,man
 gettid}.
+@end itemize
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function exists only on Linux and is therefore
+missing on most non-glibc platforms:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14.
+@end itemize
diff --git a/doc/glibc-functions/pthread_cond_clockwait.texi 
b/doc/glibc-functions/pthread_cond_clockwait.texi
new file mode 100644
index 0000000..916f2eb
--- /dev/null
+++ b/doc/glibc-functions/pthread_cond_clockwait.texi
@@ -0,0 +1,27 @@
+@node pthread_cond_clockwait
+@subsection @code{pthread_cond_clockwait}
+@findex pthread_cond_clockwait
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Non-POSIX Extensions,,Non-POSIX Extensions,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Non_002dPOSIX-Extensions.html},
+@end ifnotinfo
+@end itemize
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/pthread_mutex_clocklock.texi 
b/doc/glibc-functions/pthread_mutex_clocklock.texi
new file mode 100644
index 0000000..7f3f5d2
--- /dev/null
+++ b/doc/glibc-functions/pthread_mutex_clocklock.texi
@@ -0,0 +1,18 @@
+@node pthread_mutex_clocklock
+@subsection @code{pthread_mutex_clocklock}
+@findex pthread_mutex_clocklock
+
+Documentation: ---
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/pthread_rwlock_clockrdlock.texi 
b/doc/glibc-functions/pthread_rwlock_clockrdlock.texi
new file mode 100644
index 0000000..5e034c5
--- /dev/null
+++ b/doc/glibc-functions/pthread_rwlock_clockrdlock.texi
@@ -0,0 +1,27 @@
+@node pthread_rwlock_clockrdlock
+@subsection @code{pthread_rwlock_clockrdlock}
+@findex pthread_rwlock_clockrdlock
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Non-POSIX Extensions,,Non-POSIX Extensions,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Non_002dPOSIX-Extensions.html},
+@end ifnotinfo
+@end itemize
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/pthread_rwlock_clockwrlock.texi 
b/doc/glibc-functions/pthread_rwlock_clockwrlock.texi
new file mode 100644
index 0000000..117fb15
--- /dev/null
+++ b/doc/glibc-functions/pthread_rwlock_clockwrlock.texi
@@ -0,0 +1,27 @@
+@node pthread_rwlock_clockwrlock
+@subsection @code{pthread_rwlock_clockwrlock}
+@findex pthread_rwlock_clockwrlock
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Non-POSIX Extensions,,Non-POSIX Extensions,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Non_002dPOSIX-Extensions.html},
+@end ifnotinfo
+@end itemize
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/sem_clockwait.texi 
b/doc/glibc-functions/sem_clockwait.texi
new file mode 100644
index 0000000..3da4630
--- /dev/null
+++ b/doc/glibc-functions/sem_clockwait.texi
@@ -0,0 +1,27 @@
+@node sem_clockwait
+@subsection @code{sem_clockwait}
+@findex sem_clockwait
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Non-POSIX Extensions,,Non-POSIX Extensions,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Non_002dPOSIX-Extensions.html},
+@end ifnotinfo
+@end itemize
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/glibc-functions/tgkill.texi b/doc/glibc-functions/tgkill.texi
new file mode 100644
index 0000000..5f6f18c
--- /dev/null
+++ b/doc/glibc-functions/tgkill.texi
@@ -0,0 +1,30 @@
+@node tgkill
+@subsection @code{tgkill}
+@findex tgkill
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Signaling Another Process,,Signaling Another Process,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Signaling-Another-Process.html},
+@end ifnotinfo
+@item
+@uref{https://www.kernel.org/doc/man-pages/online/pages/man2/tgkill.2.html,,man
 tgkill}.
+@end itemize
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function exists only on Linux and is therefore
+missing on most non-glibc platforms:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14.
+@end itemize
diff --git a/doc/glibc-functions/twalk_r.texi b/doc/glibc-functions/twalk_r.texi
new file mode 100644
index 0000000..1667ae6
--- /dev/null
+++ b/doc/glibc-functions/twalk_r.texi
@@ -0,0 +1,29 @@
+@node twalk_r
+@subsection @code{twalk_r}
+@findex twalk_r
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Tree Search Function,,The tsearch function,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Tree-Search-Function.html},
+@end ifnotinfo
+@item
+@uref{https://www.kernel.org/doc/man-pages/online/pages/man3/twalk_r.3.html,,man
 twalk_r}.
+@end itemize
+
+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:
+Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 3.8, Minix 3.1.8, AIX 5.1, 
HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index 8812957..64c21ba 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -3796,6 +3796,7 @@ This list of functions is sorted according to the header 
that declares them.
 * Glibc sched.h::
 * Glibc search.h::
 * Glibc selinux/selinux.h::
+* Glibc semaphore.h::
 * Glibc shadow.h::
 * Glibc signal.h::
 * Glibc spawn.h::
@@ -4741,14 +4742,18 @@ This list of functions is sorted according to the 
header that declares them.
 @menu
 * pthread_attr_getaffinity_np::
 * pthread_attr_setaffinity_np::
+* pthread_cond_clockwait::
 * pthread_getaffinity_np::
 * pthread_getattr_default_np::
 * pthread_getattr_np::
 * pthread_getname_np::
 * pthread_kill_other_threads_np::
+* pthread_mutex_clocklock::
 * pthread_mutex_consistent_np::
 * pthread_mutexattr_getrobust_np::
 * pthread_mutexattr_setrobust_np::
+* pthread_rwlock_clockrdlock::
+* pthread_rwlock_clockwrlock::
 * pthread_rwlockattr_getkind_np::
 * pthread_rwlockattr_setkind_np::
 * pthread_setaffinity_np::
@@ -4762,14 +4767,18 @@ 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_cond_clockwait.texi
 @include glibc-functions/pthread_getaffinity_np.texi
 @include glibc-functions/pthread_getattr_default_np.texi
 @include glibc-functions/pthread_getattr_np.texi
 @include glibc-functions/pthread_getname_np.texi
 @include glibc-functions/pthread_kill_other_threads_np.texi
+@include glibc-functions/pthread_mutex_clocklock.texi
 @include glibc-functions/pthread_mutex_consistent_np.texi
 @include glibc-functions/pthread_mutexattr_getrobust_np.texi
 @include glibc-functions/pthread_mutexattr_setrobust_np.texi
+@include glibc-functions/pthread_rwlock_clockrdlock.texi
+@include glibc-functions/pthread_rwlock_clockwrlock.texi
 @include glibc-functions/pthread_rwlockattr_getkind_np.texi
 @include glibc-functions/pthread_rwlockattr_setkind_np.texi
 @include glibc-functions/pthread_setaffinity_np.texi
@@ -5483,12 +5492,14 @@ This list of functions is sorted according to the 
header that declares them.
 * hdestroy_r::
 * hsearch_r::
 * tdestroy::
+* twalk_r::
 @end menu
 
 @include glibc-functions/hcreate_r.texi
 @include glibc-functions/hdestroy_r.texi
 @include glibc-functions/hsearch_r.texi
 @include glibc-functions/tdestroy.texi
+@include glibc-functions/twalk_r.texi
 
 @node Glibc selinux/selinux.h
 @section Glibc Extensions to @code{<selinux/selinux.h>}
@@ -5504,8 +5515,14 @@ This list of functions is sorted according to the header 
that declares them.
 @include glibc-functions/getfilecon.texi
 @include glibc-functions/lgetfilecon.texi
 
-@c @node Glibc semaphore.h
-@c @section Glibc Extensions to @code{<semaphore.h>}
+@node Glibc semaphore.h
+@section Glibc Extensions to @code{<semaphore.h>}
+
+@menu
+* sem_clockwait::
+@end menu
+
+@include glibc-functions/sem_clockwait.texi
 
 @c @node Glibc setjmp.h
 @c @section Glibc Extensions to @code{<setjmp.h>}
@@ -5560,6 +5577,7 @@ This list of functions is sorted according to the header 
that declares them.
 * ssignal::
 * sys_siglist::
 * sysv_signal::
+* tgkill::
 @end menu
 
 @include glibc-functions/gsignal.texi
@@ -5575,6 +5593,7 @@ This list of functions is sorted according to the header 
that declares them.
 @include glibc-functions/ssignal.texi
 @include glibc-functions/sys_siglist.texi
 @include glibc-functions/sysv_signal.texi
+@include glibc-functions/tgkill.texi
 
 @node Glibc spawn.h
 @section Glibc Extensions to @code{<spawn.h>}
@@ -6422,6 +6441,7 @@ This list of functions is sorted according to the header 
that declares them.
 * getpass::
 * getresgid::
 * getresuid::
+* gettid::
 * getusershell::
 * group_member::
 * pipe2::
@@ -6458,6 +6478,7 @@ This list of functions is sorted according to the header 
that declares them.
 @include glibc-functions/getpass.texi
 @include glibc-functions/getresgid.texi
 @include glibc-functions/getresuid.texi
+@include glibc-functions/gettid.texi
 @include glibc-functions/getusershell.texi
 @include glibc-functions/group_member.texi
 @include glibc-functions/pipe2.texi
diff --git a/doc/pastposix-functions/h_errno.texi 
b/doc/pastposix-functions/h_errno.texi
index a1d29ae..61db68e 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.29, IRIX 6.5, Cygwin, mingw, MSVC 14, Android 9.0.
+glibc 2.30, IRIX 6.5, Cygwin, mingw, MSVC 14, Android 9.0.
 @end itemize
diff --git a/doc/posix-functions/crypt.texi b/doc/posix-functions/crypt.texi
index 66acf5a..ea1b19e 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.29, FreeBSD 6.0, NetBSD 5.0, Cygwin, mingw, MSVC 14, Android 9.0.
+glibc 2.30, FreeBSD 6.0, NetBSD 5.0, Cygwin, 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/setkey.texi b/doc/posix-functions/setkey.texi
index 3787f18..0323842 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.29, NetBSD 5.0, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
+glibc 2.30, NetBSD 5.0, Minix 3.1.8, Cygwin, mingw, MSVC 14, Android 9.0.
 @item
 This function is not declared in @code{<stdlib.h>}
 (without @code{-D_GNU_SOURCE}) on some platforms: