After each glibc release, we should update the Gnulib documentation accordingly.
This patch does it for the glibc 2.33 release (a month ago).
2021-03-06 Bruno Haible <br...@clisp.org>
free-posix: Update documentation.
* doc/posix-functions/free.texi: Add platform details.
2021-03-06 Bruno Haible <br...@clisp.org>
doc: Update for glibc 2.33.
* doc/glibc-functions/mallinfo2.texi: New file.
* doc/gnulib.texi: Include it.
(Glibc sys/vtimes.h): Remove section.
* doc/glibc-functions/vtimes.texi: Remove file.
* doc/pastposix-functions/h_errno.texi: Update.
* doc/posix-functions/*.texi: Likewise.
* doc/glibc-functions/*.texi: Likewise.
>From 3699ec9735e81cbd278146d74d99f6296c253566 Mon Sep 17 00:00:00 2001
From: Bruno Haible <br...@clisp.org>
Date: Sat, 6 Mar 2021 13:49:30 +0100
Subject: [PATCH 1/2] doc: Update for glibc 2.33.
* doc/glibc-functions/mallinfo2.texi: New file.
* doc/gnulib.texi: Include it.
(Glibc sys/vtimes.h): Remove section.
* doc/glibc-functions/vtimes.texi: Remove file.
* doc/pastposix-functions/h_errno.texi: Update.
* doc/posix-functions/*.texi: Likewise.
* doc/glibc-functions/*.texi: Likewise.
---
ChangeLog | 11 +++++++++++
doc/glibc-functions/getrandom.texi | 2 +-
doc/glibc-functions/lchmod.texi | 2 +-
doc/glibc-functions/mallinfo2.texi | 29 +++++++++++++++++++++++++++++
doc/glibc-functions/sysctl.texi | 2 +-
doc/glibc-functions/vtimes.texi | 29 -----------------------------
doc/gnulib.texi | 12 ++----------
doc/pastposix-functions/h_errno.texi | 2 +-
doc/posix-functions/crypt.texi | 2 +-
doc/posix-functions/faccessat.texi | 3 +--
doc/posix-functions/fchmodat.texi | 2 +-
doc/posix-functions/fclose.texi | 2 +-
doc/posix-functions/fflush.texi | 2 +-
doc/posix-functions/setkey.texi | 2 +-
14 files changed, 52 insertions(+), 50 deletions(-)
create mode 100644 doc/glibc-functions/mallinfo2.texi
delete mode 100644 doc/glibc-functions/vtimes.texi
diff --git a/ChangeLog b/ChangeLog
index 0873cde..c1ef60f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2021-03-06 Bruno Haible <br...@clisp.org>
+
+ doc: Update for glibc 2.33.
+ * doc/glibc-functions/mallinfo2.texi: New file.
+ * doc/gnulib.texi: Include it.
+ (Glibc sys/vtimes.h): Remove section.
+ * doc/glibc-functions/vtimes.texi: Remove file.
+ * doc/pastposix-functions/h_errno.texi: Update.
+ * doc/posix-functions/*.texi: Likewise.
+ * doc/glibc-functions/*.texi: Likewise.
+
2021-03-04 Bruno Haible <br...@clisp.org>
stddef: Generalize tcc workaround to other compilers.
diff --git a/doc/glibc-functions/getrandom.texi b/doc/glibc-functions/getrandom.texi
index 5e10963..6f2883b 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.32, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.7,
+glibc 2.33, macOS 10.15, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.7,
Minix 3.3, Haiku.
@item
diff --git a/doc/glibc-functions/lchmod.texi b/doc/glibc-functions/lchmod.texi
index 0f272ac..7514898 100644
--- a/doc/glibc-functions/lchmod.texi
+++ b/doc/glibc-functions/lchmod.texi
@@ -28,5 +28,5 @@ links.
This function can fail with @code{errno} set to @code{EMFILE} or @code{ENFILE},
and it fails with @code{errno} set to @code{EOPNOTSUPP} if the
@file{/proc} file system is not mounted:
-GNU/Linux with glibc 2.32.
+GNU/Linux with glibc 2.33.
@end itemize
diff --git a/doc/glibc-functions/mallinfo2.texi b/doc/glibc-functions/mallinfo2.texi
new file mode 100644
index 0000000..cdfe50d
--- /dev/null
+++ b/doc/glibc-functions/mallinfo2.texi
@@ -0,0 +1,29 @@
+@node mallinfo2
+@subsection @code{mallinfo2}
+@findex mallinfo2
+
+Documentation:
+@itemize
+@item
+@ifinfo
+@ref{Statistics of Malloc,,Statistics for Memory Allocation with malloc,libc},
+@end ifinfo
+@ifnotinfo
+@url{https://www.gnu.org/software/libc/manual/html_node/Statistics-of-Malloc.html},
+@end ifnotinfo
+@item
+@uref{https://www.kernel.org/doc/man-pages/online/pages/man3/mallinfo2.3.html,,man mallinfo2}.
+@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:
+glibc 2.32, Mac OS X 10.13, FreeBSD 12.0, NetBSD 9.0, OpenBSD 6.7, Minix 3.3.0, AIX 7.1, HP-UX 11.31, IRIX 6.5, Solaris 11.4, Cygwin 2.9, mingw, MSVC 14.
+@end itemize
diff --git a/doc/glibc-functions/sysctl.texi b/doc/glibc-functions/sysctl.texi
index b7cdc20..5a319ad 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:
-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.
+glibc 2.33, 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/glibc-functions/vtimes.texi b/doc/glibc-functions/vtimes.texi
deleted file mode 100644
index 1eb6e34..0000000
--- a/doc/glibc-functions/vtimes.texi
+++ /dev/null
@@ -1,29 +0,0 @@
-@node vtimes
-@subsection @code{vtimes}
-@findex vtimes
-
-Documentation:
-@itemize
-@item
-@ifinfo
-@ref{Resource Usage,,Resource Usage,libc},
-@end ifinfo
-@ifnotinfo
-@url{https://www.gnu.org/software/libc/manual/html_node/Resource-Usage.html},
-@end ifnotinfo
-@item
-@uref{https://www.kernel.org/doc/man-pages/online/pages/man3/vtimes.3.html,,man vtimes}.
-@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.13, FreeBSD 6.0, NetBSD 9.0, OpenBSD 6.7, Minix 3.1.8, AIX 5.1, HP-UX 11, IRIX 6.5, 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 7f3fdf3..53964aa 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -3913,7 +3913,6 @@ This list of functions is sorted according to the header that declares them.
* Glibc sys/uio.h::
* Glibc sys/ustat.h::
* Glibc sys/vlimit.h::
-* Glibc sys/vtimes.h::
* Glibc sys/wait.h::
* Glibc sys/xattr.h::
* Glibc termios.h::
@@ -4447,6 +4446,7 @@ This list of functions is sorted according to the header that declares them.
@menu
* mallinfo::
+* mallinfo2::
* malloc_get_state::
* malloc_set_state::
* malloc_info::
@@ -4459,6 +4459,7 @@ This list of functions is sorted according to the header that declares them.
@end menu
@include glibc-functions/mallinfo.texi
+@include glibc-functions/mallinfo2.texi
@include glibc-functions/malloc_get_state.texi
@include glibc-functions/malloc_set_state.texi
@include glibc-functions/malloc_info.texi
@@ -6392,15 +6393,6 @@ This list of functions is sorted according to the header that declares them.
@c @node Glibc sys/vm86.h
@c @section Glibc @code{<sys/vm86.h>}
-@node Glibc sys/vtimes.h
-@section Glibc @code{<sys/vtimes.h>}
-
-@menu
-* vtimes::
-@end menu
-
-@include glibc-functions/vtimes.texi
-
@node Glibc sys/wait.h
@section Glibc Extensions to @code{<sys/wait.h>}
diff --git a/doc/pastposix-functions/h_errno.texi b/doc/pastposix-functions/h_errno.texi
index 28bc0f6..2ea8f44 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.32, IRIX 6.5, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.33, 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 9581b23..97d4a36 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.32, FreeBSD 6.0, NetBSD 5.0, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.33, 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/faccessat.texi b/doc/posix-functions/faccessat.texi
index 5d5165e..c2b505b 100644
--- a/doc/posix-functions/faccessat.texi
+++ b/doc/posix-functions/faccessat.texi
@@ -31,9 +31,8 @@ which is supported by GNU @code{faccessat}.
@item
On some platforms, @code{faccessat} can mishandle @code{AT_EACCESS}
after a process starts as root and then becomes non-root:
-GNU/Linux with glibc 2.32.
-@c This bug should be fixed in glibc 2.33. See:
@c https://sourceware.org/bugzilla/show_bug.cgi?id=18683
+GNU/Linux with glibc 2.32.
@end itemize
Other problems of this function:
diff --git a/doc/posix-functions/fchmodat.texi b/doc/posix-functions/fchmodat.texi
index aa0c0fd..6a6cbb7 100644
--- a/doc/posix-functions/fchmodat.texi
+++ b/doc/posix-functions/fchmodat.texi
@@ -35,5 +35,5 @@ If the @code{AT_SYMLINK_NOFOLLOW} flag is specified,
this function can fail with @code{errno} set to @code{EMFILE} or @code{ENFILE},
and it fails with @code{errno} set to @code{EOPNOTSUPP} if the
@file{/proc} file system is not mounted:
-GNU/Linux with glibc 2.32.
+GNU/Linux with glibc 2.33.
@end itemize
diff --git a/doc/posix-functions/fclose.texi b/doc/posix-functions/fclose.texi
index fb83f6a..4d0d7ec 100644
--- a/doc/posix-functions/fclose.texi
+++ b/doc/posix-functions/fclose.texi
@@ -11,7 +11,7 @@ Portability problems fixed by Gnulib:
@item
On some platforms, this function fails to set the file position of a
seekable input stream to the byte after the last one actually read:
-glibc 2.32, FreeBSD, AIX 7.2.
+glibc 2.33, FreeBSD, AIX 7.2.
@item
This function crashes if the stream's file descriptor has already been
closed on some platforms:
diff --git a/doc/posix-functions/fflush.texi b/doc/posix-functions/fflush.texi
index 665951d..12b68e5 100644
--- a/doc/posix-functions/fflush.texi
+++ b/doc/posix-functions/fflush.texi
@@ -12,7 +12,7 @@ Portability problems fixed by Gnulib:
@code{fflush} followed by @code{fseek} or @code{fseeko}, applied to an input
stream, should have the effect of positioning the underlying file descriptor.
It doesn't do this on some platforms:
-glibc 2.32 and others.
+glibc 2.33 and others.
@item
@code{fflush} on an input stream changes the position of the stream to the
end of the previous buffer, on some platforms: mingw, MSVC 14.
diff --git a/doc/posix-functions/setkey.texi b/doc/posix-functions/setkey.texi
index c7853f3..6b69090 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.32, NetBSD 5.0, OpenBSD 6.7, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 9.0.
+glibc 2.33, NetBSD 5.0, OpenBSD 6.7, 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.7.4
>From fa6c6f2a3947fd72b3e15cc12c2c2ed26d3dd5bd Mon Sep 17 00:00:00 2001
From: Bruno Haible <br...@clisp.org>
Date: Sat, 6 Mar 2021 13:49:52 +0100
Subject: [PATCH 2/2] free-posix: Update documentation.
* doc/posix-functions/free.texi: Add platform details.
---
ChangeLog | 5 +++++
doc/posix-functions/free.texi | 3 ++-
2 files changed, 7 insertions(+), 1 deletion(-)
diff --git a/ChangeLog b/ChangeLog
index c1ef60f..86c3e04 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
2021-03-06 Bruno Haible <br...@clisp.org>
+ free-posix: Update documentation.
+ * doc/posix-functions/free.texi: Add platform details.
+
+2021-03-06 Bruno Haible <br...@clisp.org>
+
doc: Update for glibc 2.33.
* doc/glibc-functions/mallinfo2.texi: New file.
* doc/gnulib.texi: Include it.
diff --git a/doc/posix-functions/free.texi b/doc/posix-functions/free.texi
index a7ceec1..1d16fe8 100644
--- a/doc/posix-functions/free.texi
+++ b/doc/posix-functions/free.texi
@@ -9,7 +9,8 @@ Gnulib module: free-posix
Portability problems fixed by Gnulib:
@itemize
@item
-This function may clobber @code{errno} on many platforms.
+This function may clobber @code{errno} on many platforms:
+glibc 2.32, Mac OS X, FreeBSD, NetBSD, OpenBSD 4.4, Minix, AIX, HP-UX, IRIX, Cygwin, mingw, MSVC.
@end itemize
Portability problems not fixed by Gnulib:
--
2.7.4
