changeset 17659:3e1daa05022b

doc: document mbrtowc and mbrlen problem with empty input * doc/posix-functions/mbrlen.texi (mbrlen): * doc/posix-functions/mbrtowc.texi (mbrtowc): Document portability problem when the input string is empty. See: https://sourceware.org/bugzilla/show_bug.cgi?id=16950
author Paul Eggert <eggert@cs.ucla.edu>
date Thu, 15 May 2014 18:30:04 -0700
parents c8e1e9450f92
children ea9dc06bfca8
files ChangeLog doc/posix-functions/mbrlen.texi doc/posix-functions/mbrtowc.texi
diffstat 3 files changed, 22 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Thu May 15 13:07:50 2014 -0700
+++ b/ChangeLog	Thu May 15 18:30:04 2014 -0700
@@ -1,5 +1,11 @@
 2014-05-15  Paul Eggert  <eggert@cs.ucla.edu>
 
+	doc: document mbrtowc and mbrlen problem with empty input
+	* doc/posix-functions/mbrlen.texi (mbrlen):
+	* doc/posix-functions/mbrtowc.texi (mbrtowc):
+	Document portability problem when the input string is empty.  See:
+	https://sourceware.org/bugzilla/show_bug.cgi?id=16950
+
 	doc: document exec* = spawn+exit bug with non-Cygwin Windows platforms
 	Problem reported by Eli Zaretskii in:
 	http://lists.gnu.org/archive/html/bug-grep/2014-05/msg00118.html
--- a/doc/posix-functions/mbrlen.texi	Thu May 15 13:07:50 2014 -0700
+++ b/doc/posix-functions/mbrlen.texi	Thu May 15 18:30:04 2014 -0700
@@ -12,6 +12,14 @@
 This function is missing on some platforms:
 Minix 3.1.8, HP-UX 11.00, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5.
 @item
+This function returns 0 instead of @code{(size_t) -2} when the input
+is empty:
+glibc 2.19.
+@item
+This function returns @code{(size_t) -1} instead of @code{(size_t) -2}
+when the input is empty:
+AIX 5.1.
+@item
 This function does not put the state into non-initial state when parsing an
 incomplete multibyte character on some platforms:
 AIX 5.1, OSF/1 5.1.
--- a/doc/posix-functions/mbrtowc.texi	Thu May 15 13:07:50 2014 -0700
+++ b/doc/posix-functions/mbrtowc.texi	Thu May 15 18:30:04 2014 -0700
@@ -12,6 +12,14 @@
 This function is missing on some platforms:
 Minix 3.1.8, HP-UX 11.00, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5.
 @item
+This function returns 0 instead of @code{(size_t) -2} when the input
+is empty:
+glibc 2.19.
+@item
+This function returns @code{(size_t) -1} instead of @code{(size_t) -2}
+when the input is empty:
+AIX 5.1.
+@item
 This function does not put the state into non-initial state when parsing an
 incomplete multibyte character on some platforms:
 AIX 5.1, OSF/1 5.1.