From 92ee1fe627850db285330dcd71a516d2e71bbfa4 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Mon, 22 Mar 2021 13:47:44 +0100 Subject: [PATCH] doc: Mention an open glibc bug. * doc/posix-functions/mbrtowc.texi: Mention the possible out-of-range wchar_t values returned by this function on glibc. * doc/posix-functions/mbtowc.texi: Likewise. --- ChangeLog | 7 +++++++ doc/posix-functions/mbrtowc.texi | 6 ++++++ doc/posix-functions/mbtowc.texi | 6 ++++++ 3 files changed, 19 insertions(+) diff --git a/ChangeLog b/ChangeLog index 5428778086..d0cbc60237 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2021-03-22 Bruno Haible + + doc: Mention an open glibc bug. + * doc/posix-functions/mbrtowc.texi: Mention the possible out-of-range + wchar_t values returned by this function on glibc. + * doc/posix-functions/mbtowc.texi: Likewise. + 2021-03-22 Benno Schulenberg (tiny change) mbrtowc: Remove a redundant condition. diff --git a/doc/posix-functions/mbrtowc.texi b/doc/posix-functions/mbrtowc.texi index 897e4da942..291207ec32 100644 --- a/doc/posix-functions/mbrtowc.texi +++ b/doc/posix-functions/mbrtowc.texi @@ -44,6 +44,12 @@ Solaris 9. Portability problems not fixed by Gnulib: @itemize @item +In UTF-8 locales, this function may return wide characters up to 0x7FFFFFFF +(that is, beyond 0x0010FFFF) on some platforms: +@c https://sourceware.org/bugzilla/show_bug.cgi?id=2373 +@c https://sourceware.org/bugzilla/show_bug.cgi?id=26034 +glibc 2.33. +@item On Windows and 32-bit AIX platforms, @code{wchar_t} is a 16-bit type and therefore cannot accommodate all Unicode characters. However, the ISO C11 function @code{mbrtoc32}, provided by Gnulib module diff --git a/doc/posix-functions/mbtowc.texi b/doc/posix-functions/mbtowc.texi index e7e537690b..855f825d5d 100644 --- a/doc/posix-functions/mbtowc.texi +++ b/doc/posix-functions/mbtowc.texi @@ -16,6 +16,12 @@ Android 4.4. Portability problems not fixed by Gnulib: @itemize @item +In UTF-8 locales, this function may return wide characters up to 0x7FFFFFFF +(that is, beyond 0x0010FFFF) on some platforms: +@c https://sourceware.org/bugzilla/show_bug.cgi?id=2373 +@c https://sourceware.org/bugzilla/show_bug.cgi?id=26034 +glibc 2.33. +@item This function accumulates hidden state on some platforms: glibc 2.8 (see @url{https://sourceware.org/bugzilla/show_bug.cgi?id=9674}). @item -- 2.39.5