Libc-1439.100.3.tar.gz

[apple/libc.git] / locale / FreeBSD / setlocale.3

diff --git a/locale/FreeBSD/setlocale.3 b/locale/FreeBSD/setlocale.3
index 6d3be0354b924d59900528eb9bff31f061a8eec9..8c263b9c36c8317a0d3cdb0a9bc691a25ebc132a 100644 (file)
--- a/locale/FreeBSD/setlocale.3
+++ b/locale/FreeBSD/setlocale.3
@@ -29,7 +29,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)setlocale.3 8.1 (Berkeley) 6/9/93
-.\" $FreeBSD: src/lib/libc/locale/setlocale.3,v 1.35 2007/01/09 00:28:00 imp Exp $
+.\" $FreeBSD$
 .\"
 .Dd November 21, 2003
 .Dt SETLOCALE 3
@@ -60,7 +60,6 @@ The
 .Fn setlocale
 function recognizes several categories of routines.
 These are the categories and the sets of routines they select:
-.Pp
 .Bl -tag -width LC_MONETARY
 .It Dv LC_ALL
 Set the entire locale generically.
@@ -106,21 +105,25 @@ function.
 .Pp
 Only three locales are defined by default:
 the empty string
-.Li "\&""\|""
+.Li \&"\|"
 (which denotes the native environment) and the
-.Li "\&""C""
+.Li \&"C"
 and
-.Li "\&""POSIX""
-locales (which denote the C-language environment).
+.Li \&"POSIX"
+locales (which denote the C language environment).
 A
 .Fa locale
 argument of
 .Dv NULL
 causes
 .Fn setlocale
-to return the current locale.
+to return the current locale.  An argument of
+.Li \&"\|"
+will determine the name of the new locale taking into account the environment
+variables LANG and LC_*.  If these environment variables yield a locale that is
+invalid, NULL will be returned and the current locale will remain unchanged.
 By default, C programs start in the
-.Li "\&""C""
+.Li \&"C"
 locale.
 The only function in the library that sets the locale is
 .Fn setlocale ;
@@ -150,6 +153,11 @@ locale file for the locale
 .Em locale
 and the category
 .Em category .
+.It Pa /usr/local/share/locale/ Ns Em locale/category
+locale file for the locale
+.Em locale
+and the category
+.Em category .
 .El
 .Sh ERRORS
 No errors are defined.