summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-functions/setlocale.texi
diff options
context:
space:
mode:
authorRichard Maw <richard.maw@codethink.co.uk>2012-01-17 14:43:55 +0000
committerRichard Maw <richard.maw@codethink.co.uk>2012-01-17 14:43:55 +0000
commit2de9abc5c9d40b3c716307d67d16146f823fd554 (patch)
tree6979db67934ddc8b564150b465846a383b428ff8 /gnulib/doc/posix-functions/setlocale.texi
parent33cc1c6fda6e72a7bae1401e9b2cec495a4d3ff1 (diff)
downloadpatch-baserock/bootstrap-pass2.tar.gz
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