X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fmbsrtowcs.texi;h=bc4e91475da373aade6eb2889bb82d89f660f0f9;hb=a155c5688ab059c1c2fff7f132116b455ddb37ba;hp=72682c66a71deddd8299b779ad7515e240780692;hpb=7ec4dd0757faee6c51e3b20119dded0b321c3199;p=gnulib.git diff --git a/doc/posix-functions/mbsrtowcs.texi b/doc/posix-functions/mbsrtowcs.texi index 72682c66a..bc4e91475 100644 --- a/doc/posix-functions/mbsrtowcs.texi +++ b/doc/posix-functions/mbsrtowcs.texi @@ -10,12 +10,22 @@ Portability problems fixed by Gnulib: @itemize @item This function is missing on some platforms: -HP-UX 11, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5. +HP-UX 11.00, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5. +@item +This function does not work on some platforms: +HP-UX 11, Solaris 10. @end itemize Portability problems not fixed by Gnulib: @itemize @item -On Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot +On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot accommodate all Unicode characters. +@item +The specification is not clear about whether this function should update the +conversion state when the first argument (the destination pointer) is NULL. +The glibc implementation does not update the state in this case; the MacOS X +and FreeBSD implementations do. +For portability, when passing a NULL destination argument, it is best to pass +a pointer to a temporary copy of the conversion state. @end itemize