--- posix.texi.~1.18.~	2003-05-03 09:45:20.000000000 +1000
+++ posix.texi	2003-05-22 10:48:32.000000000 +1000
@@ -2660,22 +2660,28 @@
 
 @deffn {Scheme Procedure} setlocale category [locale]
 @deffnx {C Function} scm_setlocale (category, locale)
address@hidden LC_ALL
address@hidden LC_COLLATE
address@hidden LC_CTYPE
address@hidden LC_MESSAGES
address@hidden LC_MONETARY
address@hidden LC_NUMERIC
address@hidden LC_TIME
-If @var{locale} is omitted, return the current value of the specified
-locale @var{category} as a system-dependent string.  @var{category}
-should be specified using the values @code{LC_COLLATE}, @code{LC_ALL}
-etc; see @inforef{Locating Catalogs,, gettext}.
-
-Otherwise the specified locale category is set to the string
address@hidden and the new value is returned as a
-system-dependent string.  If @var{locale} is an empty string,
-the locale will be set using environment variables.
+Get or set the current locale, used for various internationalizations.
+Locales are strings, for instance @samp{sv_SE}.
+
+If @var{locale} is given then the locale for the given category is set
+and the new value returned.  If @var{locale} is not given then the
+current value of the category is returned.  @var{category} should be
+one of the following values
+
address@hidden LC_ALL
address@hidden LC_COLLATE
address@hidden LC_CTYPE
address@hidden LC_MESSAGES
address@hidden LC_MONETARY
address@hidden LC_NUMERIC
address@hidden LC_TIME
address@hidden defvar
+
+A common usage is @samp{(setlocale LC_ALL "")}, which initializes all
+categories based on standard environment variables (@code{LANG} etc).
+For full details on categories and locale names @pxref{Locales,,
+Locales and Internationalization, libc, The GNU C Library Reference
+Manual}.
 @end deffn
 
 @node Encryption