doc: Document free_aligned_sized and free_sized added in C23.
authorCollin Funk <collin.funk1@gmail.com>
Sun, 9 Feb 2025 01:40:48 +0000 (17:40 -0800)
committerCollin Funk <collin.funk1@gmail.com>
Sun, 9 Feb 2025 01:40:48 +0000 (17:40 -0800)
* doc/posix-functions/free_aligned_sized.texi: New file.
* doc/posix-functions/free_sized.texi: New file.
* doc/gnulib.texi (Functions in <stdlib.h>): Include them.

ChangeLog
doc/gnulib.texi
doc/posix-functions/free_aligned_sized.texi [new file with mode: 0644]
doc/posix-functions/free_sized.texi [new file with mode: 0644]

index 7e0b8163a5bdbd1996e27eb0c16c8d736a5ee053..11912cd67aa0c2e02f6e2fe80ac84fc0cc0c630b 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2025-02-08  Collin Funk  <collin.funk1@gmail.com>
+
+       doc: Document free_aligned_sized and free_sized added in C23.
+       * doc/posix-functions/free_aligned_sized.texi: New file.
+       * doc/posix-functions/free_sized.texi: New file.
+       * doc/gnulib.texi (Functions in <stdlib.h>): Include them.
+
 2025-02-08  Paul Eggert  <eggert@cs.ucla.edu>
 
        memalignment: document
index 4d0cfd26d5c4528aad893f601e0a71eca8474048..31a206f8fb03a9ff66b36f7371262993bd9e112a 100644 (file)
@@ -3585,6 +3585,8 @@ This list of functions is sorted according to the header that declares them.
 * erand48::
 * exit::
 * free::
+* free_aligned_sized::
+* free_sized::
 * getenv::
 * getsubopt::
 * grantpt::
@@ -3664,6 +3666,8 @@ This list of functions is sorted according to the header that declares them.
 @include posix-functions/erand48.texi
 @include posix-functions/exit.texi
 @include posix-functions/free.texi
+@include posix-functions/free_aligned_sized.texi
+@include posix-functions/free_sized.texi
 @include posix-functions/getenv.texi
 @include posix-functions/getsubopt.texi
 @include posix-functions/grantpt.texi
diff --git a/doc/posix-functions/free_aligned_sized.texi b/doc/posix-functions/free_aligned_sized.texi
new file mode 100644 (file)
index 0000000..9074692
--- /dev/null
@@ -0,0 +1,18 @@
+@node free_aligned_sized
+@subsection @code{free_aligned_sized}
+@findex free_aligned_sized
+
+ISO C23 specification:@* @url{https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf} section 7.24.3.5
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on most non-C23 platforms:
+glibc 2.41, macOS 14, FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5, Minix 3.3.0, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, Cygwin 3.5.3, mingw, MSVC 14, Android 9.0.
+@end itemize
diff --git a/doc/posix-functions/free_sized.texi b/doc/posix-functions/free_sized.texi
new file mode 100644 (file)
index 0000000..f6d750c
--- /dev/null
@@ -0,0 +1,18 @@
+@node free_sized
+@subsection @code{free_sized}
+@findex free_sized
+
+ISO C23 specification:@* @url{https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf} section 7.24.3.4
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on most non-C23 platforms:
+glibc 2.41, macOS 14, FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.5, Minix 3.3.0, AIX 7.3.1, HP-UX 11.31, Solaris 11.4, Cygwin 3.5.3, mingw, MSVC 14, Android 9.0.
+@end itemize