summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-functions/mbsrtowcs.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/posix-functions/mbsrtowcs.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/posix-functions/mbsrtowcs.texi34
2 files changed, 34 insertions, 0 deletions
diff --git a/gnulib b/gnulib
deleted file mode 160000
-Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1
diff --git a/gnulib/doc/posix-functions/mbsrtowcs.texi b/gnulib/doc/posix-functions/mbsrtowcs.texi
new file mode 100644
index 0000000..8d218a3
--- /dev/null
+++ b/gnulib/doc/posix-functions/mbsrtowcs.texi
@@ -0,0 +1,34 @@
+@node mbsrtowcs
+@section @code{mbsrtowcs}
+@findex mbsrtowcs
+
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsrtowcs.html}
+
+Gnulib module: mbsrtowcs
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+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 does not work on some platforms:
+HP-UX 11, Solaris 11 2010-11.
+@item
+This function does not work when the first argument is NULL on some platforms:
+mingw.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+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