pthread_sigmask: Ensure declaration in <signal.h> also on Solaris 2.6.
[pspp] / doc / posix-functions / setlocale.texi
index f1c3736ce53587fcf1cb9f650274e40bb196cce2..ee4d477906ff5336402a49c99b938e3ba36dfaad 100644 (file)
@@ -2,17 +2,31 @@
 @section @code{setlocale}
 @findex setlocale
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/setlocale.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/setlocale.html}
 
-Gnulib module: ---
+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, which doesn't have locales, @code{setlocale(LC_ALL,NULL)} always
-returns @code{"C"}.
+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