]> Savannah Git Hosting - gnulib.git/commitdiff
mbrtoc32: document (size_t) -3 issue
authorPaul Eggert <eggert@cs.ucla.edu>
Mon, 3 Jul 2023 17:24:05 +0000 (10:24 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Mon, 3 Jul 2023 17:26:12 +0000 (10:26 -0700)
* doc/posix-functions/mbrtoc32.texi (mbrtoc32):
Say (size_t) -3 might not be worth bothering about.

ChangeLog
doc/posix-functions/mbrtoc32.texi

index 7cd5aac216b4dfe71192177a1a7916e2f4fcbe9f..7d44959df2d55d80fe7a75028b5151fde069c54c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2023-07-03  Paul Eggert  <eggert@cs.ucla.edu>
+
+       mbrtoc32: document (size_t) -3 issue
+       * doc/posix-functions/mbrtoc32.texi (mbrtoc32):
+       Say (size_t) -3 might not be worth bothering about.
+
 2023-07-02  Bruno Haible  <bruno@clisp.org>
 
        mbsrtoc32s: Accommodate a difference between mbrtowc and mbrtoc32.
index db7d6a082140215cb6ea31fbf6c55e903b4e0914..93a7aa64ff64835315711ccc164d774a112c4c97 100644 (file)
@@ -38,6 +38,12 @@ Solaris 11.4, mingw, MSVC 14.
 Portability problems not fixed by Gnulib:
 @itemize
 @item
+Although ISO C says this function can return @code{(size_t) -3},
+no known implementation behaves that way,
+and if it were to happen it would break common uses.
+If dealing with @code{(size_t) -3} would complicate your code significantly,
+it is probably better not to bother.
+@item
 This function is only defined as an inline function on some platforms:
 Haiku 2020.
 @end itemize