ISO C 23 introduces two new functions, c8rtomb and mbrtoc8. POSIX does not
have them yet, but will surely add them in the future. No system implements
these functions so far. But the Gnulib doc should mention them.

This patch does it.


2023-06-28  Bruno Haible  <[email protected]>

        doc: Mention c8rtomb and mbrtoc8 from ISO C 23.
        * doc/posix-functions/c8rtomb.texi: New file.
        * doc/posix-functions/mbrtoc8.texi: New file.
        * doc/gnulib.texi (Function Substitutes): Include them.

>From 46f9c21a08245fe224fd975de8632b04a0256387 Mon Sep 17 00:00:00 2001
From: Bruno Haible <[email protected]>
Date: Wed, 28 Jun 2023 19:27:26 +0200
Subject: [PATCH] doc: Mention c8rtomb and mbrtoc8 from ISO C 23.

* doc/posix-functions/c8rtomb.texi: New file.
* doc/posix-functions/mbrtoc8.texi: New file.
* doc/gnulib.texi (Function Substitutes): Include them.
---
 ChangeLog                        |  7 +++++++
 doc/gnulib.texi                  |  4 ++++
 doc/posix-functions/c8rtomb.texi | 16 ++++++++++++++++
 doc/posix-functions/mbrtoc8.texi | 16 ++++++++++++++++
 4 files changed, 43 insertions(+)
 create mode 100644 doc/posix-functions/c8rtomb.texi
 create mode 100644 doc/posix-functions/mbrtoc8.texi

diff --git a/ChangeLog b/ChangeLog
index 319be18c40..08c0b31070 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2023-06-28  Bruno Haible  <[email protected]>
+
+	doc: Mention c8rtomb and mbrtoc8 from ISO C 23.
+	* doc/posix-functions/c8rtomb.texi: New file.
+	* doc/posix-functions/mbrtoc8.texi: New file.
+	* doc/gnulib.texi (Function Substitutes): Include them.
+
 2023-06-28  Bruno Haible  <[email protected]>
 
 	mbrtoc16: Add tests.
diff --git a/doc/gnulib.texi b/doc/gnulib.texi
index f36a0cf720..a98ddef7a7 100644
--- a/doc/gnulib.texi
+++ b/doc/gnulib.texi
@@ -1283,6 +1283,7 @@
 * bind::
 * bsearch::
 * btowc::
+* c8rtomb::
 * c16rtomb::
 * c32rtomb::
 * cabs::
@@ -1814,6 +1815,7 @@
 * malloc::
 * mblen::
 * mbrlen::
+* mbrtoc8::
 * mbrtoc16::
 * mbrtoc32::
 * mbrtowc::
@@ -2577,6 +2579,7 @@
 @include posix-functions/bind.texi
 @include posix-functions/bsearch.texi
 @include posix-functions/btowc.texi
+@include posix-functions/c8rtomb.texi
 @include posix-functions/c16rtomb.texi
 @include posix-functions/c32rtomb.texi
 @include posix-functions/cabs.texi
@@ -3108,6 +3111,7 @@
 @include posix-functions/malloc.texi
 @include posix-functions/mblen.texi
 @include posix-functions/mbrlen.texi
+@include posix-functions/mbrtoc8.texi
 @include posix-functions/mbrtoc16.texi
 @include posix-functions/mbrtoc32.texi
 @include posix-functions/mbrtowc.texi
diff --git a/doc/posix-functions/c8rtomb.texi b/doc/posix-functions/c8rtomb.texi
new file mode 100644
index 0000000000..7070412554
--- /dev/null
+++ b/doc/posix-functions/c8rtomb.texi
@@ -0,0 +1,16 @@
+@node c8rtomb
+@section @code{c8rtomb}
+@findex c8rtomb
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on most platforms:
+glibc 2.29, macOS 11.1, FreeBSD 13.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, Android 9.0.
+@end itemize
diff --git a/doc/posix-functions/mbrtoc8.texi b/doc/posix-functions/mbrtoc8.texi
new file mode 100644
index 0000000000..ef68758004
--- /dev/null
+++ b/doc/posix-functions/mbrtoc8.texi
@@ -0,0 +1,16 @@
+@node mbrtoc8
+@section @code{mbrtoc8}
+@findex mbrtoc8
+
+Gnulib module: ---
+
+Portability problems fixed by Gnulib:
+@itemize
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+This function is missing on most platforms:
+glibc 2.29, macOS 11.1, FreeBSD 13.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, Android 9.0.
+@end itemize
-- 
2.34.1

Reply via email to