summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-functions/setlocale.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/posix-functions/setlocale.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/posix-functions/setlocale.texi32
2 files changed, 32 insertions, 0 deletions
diff --git a/gnulib b/gnulib
deleted file mode 160000
-Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1
diff --git a/gnulib/doc/posix-functions/setlocale.texi b/gnulib/doc/posix-functions/setlocale.texi
new file mode 100644
index 0000000..ee4d477
--- /dev/null
+++ b/gnulib/doc/posix-functions/setlocale.texi
@@ -0,0 +1,32 @@
+@node setlocale
+@section @code{setlocale}
+@findex setlocale
+
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/setlocale.html}
+
+Gnulib module: setlocale
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+On Windows platforms (excluding Cygwin), @code{setlocale(@var{category},NULL)}
+ignores the environment variables @code{LC_ALL}, @code{@var{category}}, and
+@code{LANG}.
+@item
+On Windows platforms (excluding Cygwin) and Cygwin 1.5.x,
+@code{setlocale(LC_ALL,@var{name})} succeeds and sets the LC_CTYPE category to
+@samp{C} when it does not support the encoding, instead of failing.
+@item
+On Windows platforms (excluding Cygwin), @code{setlocale} understands different
+locale names, that are not based on ISO 639 language names and ISO 3166 country
+names.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+On Cygwin 1.5.x, which doesn't have locales,
+@code{setlocale(LC_ALL,NULL)} always returns @code{"C"}.
+@item
+On Cygwin 1.7.0, only the charset portion of a locale designation is honored.
+@end itemize