To make it easier to track the reported bugs:
2023-06-30 Bruno Haible <br...@clisp.org>
doc: Reference some reported bugs (in comments).
* doc/posix-functions/mbrlen.texi: Add references to bug reports.
* doc/posix-functions/mbrtoc16.texi: Likewise.
* doc/posix-functions/mbrtoc32.texi: Likewise.
* doc/posix-functions/mbrtowc.texi: Likewise.
* doc/posix-functions/mbsnrtowcs.texi: Likewise.
* doc/posix-functions/mbsrtowcs.texi: Likewise.
* doc/posix-functions/mbstowcs.texi: Likewise.
diff --git a/doc/posix-functions/mbrlen.texi b/doc/posix-functions/mbrlen.texi
index 0c55ddae21..9545d4c16e 100644
--- a/doc/posix-functions/mbrlen.texi
+++ b/doc/posix-functions/mbrlen.texi
@@ -14,6 +14,8 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@item
This function returns 0 instead of @code{(size_t) -2} when the input
diff --git a/doc/posix-functions/mbrtoc16.texi
b/doc/posix-functions/mbrtoc16.texi
index ed568d593f..2c483f5170 100644
--- a/doc/posix-functions/mbrtoc16.texi
+++ b/doc/posix-functions/mbrtoc16.texi
@@ -16,11 +16,16 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.36.
@item
This function returns 0 instead of @code{(size_t) -2} when the input
is empty:
-glibc 2.19, Android 11.
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=16950
+glibc 2.19,
+@c https://issuetracker.google.com/issues/289419880
+Android 11.
@item
This function returns the total number of bytes that make up the multibyte
character, not the number of bytes that were needed to complete the multibyte
@@ -30,11 +35,14 @@
This function returns @code{(size_t) -3} instead of a byte count when it
has stored a high surrogate, and returns a byte count instead of
@code{(size_t) -3} when it has stored a low surrogate, on some platforms:
+@c https://issuetracker.google.com/issues/289419882
Android.
@item
This function does not recognize multibyte sequences that @code{mbrtowc}
recognizes on some platforms:
-FreeBSD 13.2, Solaris 11.4, MSVC 14.
+@c https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=272293
+FreeBSD 13.2,
+Solaris 11.4, MSVC 14.
@c For MSVC this is because it assumes that the input is always UTF-8 encoded.
@c See
https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/mbrtoc16-mbrtoc323
@end itemize
diff --git a/doc/posix-functions/mbrtoc32.texi
b/doc/posix-functions/mbrtoc32.texi
index 8792a7b11b..db7d6a0821 100644
--- a/doc/posix-functions/mbrtoc32.texi
+++ b/doc/posix-functions/mbrtoc32.texi
@@ -12,17 +12,25 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@item
This function returns 0 instead of @code{(size_t) -2} when the input
is empty:
-glibc 2.19, mingw, Android 11,
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=16950
+glibc 2.19,
+mingw,
+@c https://issuetracker.google.com/issues/289419880
+Android 11,
@c https://dev.haiku-os.org/ticket/18350
Haiku.
@item
This function does not recognize multibyte sequences that @code{mbrtowc}
recognizes on some platforms:
-FreeBSD 13.0, Solaris 11.4, mingw, MSVC 14.
+@c https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=272293
+FreeBSD 13.2,
+Solaris 11.4, mingw, MSVC 14.
@c For MSVC this is because it assumes that the input is always UTF-8 encoded.
@c See
https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/mbrtoc16-mbrtoc323
@end itemize
diff --git a/doc/posix-functions/mbrtowc.texi b/doc/posix-functions/mbrtowc.texi
index 52471978fc..f61b4806c6 100644
--- a/doc/posix-functions/mbrtowc.texi
+++ b/doc/posix-functions/mbrtowc.texi
@@ -14,11 +14,15 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@item
This function returns 0 instead of @code{(size_t) -2} when the input
is empty:
-glibc 2.19, MSVC 14, Android 11.
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=16950
+glibc 2.19,
+MSVC 14, Android 11.
@item
This function returns @code{(size_t) -1} instead of @code{(size_t) -2}
when the input is empty:
diff --git a/doc/posix-functions/mbsnrtowcs.texi
b/doc/posix-functions/mbsnrtowcs.texi
index 3a420c673a..ae389b414d 100644
--- a/doc/posix-functions/mbsnrtowcs.texi
+++ b/doc/posix-functions/mbsnrtowcs.texi
@@ -17,6 +17,8 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@end itemize
diff --git a/doc/posix-functions/mbsrtowcs.texi
b/doc/posix-functions/mbsrtowcs.texi
index 28c450ddfb..88da2a06aa 100644
--- a/doc/posix-functions/mbsrtowcs.texi
+++ b/doc/posix-functions/mbsrtowcs.texi
@@ -17,6 +17,8 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@item
This function does not work when the first argument is NULL on some platforms:
diff --git a/doc/posix-functions/mbstowcs.texi
b/doc/posix-functions/mbstowcs.texi
index a695edc2af..2071219d6c 100644
--- a/doc/posix-functions/mbstowcs.texi
+++ b/doc/posix-functions/mbstowcs.texi
@@ -11,6 +11,8 @@
@item
In the C or POSIX locales, this function can return @code{(size_t) -1}
and set @code{errno} to @code{EILSEQ}:
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=19932
+@c https://sourceware.org/bugzilla/show_bug.cgi?id=29511
glibc 2.35.
@end itemize
