From: Paul Eggert Date: Mon, 3 Jul 2023 17:24:05 +0000 (-0700) Subject: mbrtoc32: document (size_t) -3 issue X-Git-Tag: v1.0~1151 X-Git-Url: https://gitweb.git.savannah.gnu.org/gitweb/?a=commitdiff_plain;h=e046d5458353f112e78893ca03d855c8a9aa2e39;p=gnulib.git mbrtoc32: document (size_t) -3 issue * doc/posix-functions/mbrtoc32.texi (mbrtoc32): Say (size_t) -3 might not be worth bothering about. --- diff --git a/ChangeLog b/ChangeLog index 7cd5aac216..7d44959df2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2023-07-03 Paul Eggert + + 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 mbsrtoc32s: Accommodate a difference between mbrtowc and mbrtoc32. diff --git a/doc/posix-functions/mbrtoc32.texi b/doc/posix-functions/mbrtoc32.texi index db7d6a0821..93a7aa64ff 100644 --- a/doc/posix-functions/mbrtoc32.texi +++ b/doc/posix-functions/mbrtoc32.texi @@ -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