X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2Fposix-functions%2Fmbsrtowcs.texi;h=28d342f284cb8bfa222cdf812601618a83c9c790;hb=14b6d70139486b63e66257aad1abe2a9615f4d96;hp=72682c66a71deddd8299b779ad7515e240780692;hpb=7ec4dd0757faee6c51e3b20119dded0b321c3199;p=gnulib.git

diff --git a/doc/posix-functions/mbsrtowcs.texi b/doc/posix-functions/mbsrtowcs.texi
index 72682c66a..28d342f28 100644
--- a/doc/posix-functions/mbsrtowcs.texi
+++ b/doc/posix-functions/mbsrtowcs.texi
@@ -2,7 +2,7 @@
 @section @code{mbsrtowcs}
 @findex mbsrtowcs
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsrtowcs.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsrtowcs.html}
 
 Gnulib module: mbsrtowcs
 
@@ -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