doco setlocale

doco setlocale

[Kevin Ryde]

[-- Attachment #1: Type: text/plain, Size: 1263 bytes --]

A bit of polish to propose for the setlocale documentation.

        * posix.texi (Locales): Clarify setlocale a bit, list all categories,
        cross reference to libc.

I think it's better to refer to the libc manual then the gettext one,
since setlocale lives in libc and it's there that stuff like strftime
gets influenced.


Locales
=======

 - Scheme Procedure: setlocale category [locale]
 - C Function: scm_setlocale (category, locale)
     Get or set the current locale, used for various
     internationalizations.  Locales are strings, for instance `sv_SE'.

     If LOCALE is given then the locale for the given category is set
     and the new value returned.  If LOCALE is not given then the
     current value of the category is returned.  CATEGORY should be one
     of the following values

      - Variable: LC_ALL
      - Variable: LC_COLLATE
      - Variable: LC_CTYPE
      - Variable: LC_MESSAGES
      - Variable: LC_MONETARY
      - Variable: LC_NUMERIC
      - Variable: LC_TIME

     A common usage is `(setlocale LC_ALL "")', which initializes all
     categories based on standard environment variables (`LANG' etc).
     For full details on categories and locale names *note Locales and
     Internationalization: (libc)Locales..



[-- Attachment #2: posix.texi.setlocale.diff --]
[-- Type: text/plain, Size: 1705 bytes --]

--- 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)
-@vindex LC_ALL
-@vindex LC_COLLATE
-@vindex LC_CTYPE
-@vindex LC_MESSAGES
-@vindex LC_MONETARY
-@vindex LC_NUMERIC
-@vindex 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
-@var{locale} 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
+
+@defvar LC_ALL
+@defvarx LC_COLLATE
+@defvarx LC_CTYPE
+@defvarx LC_MESSAGES
+@defvarx LC_MONETARY
+@defvarx LC_NUMERIC
+@defvarx LC_TIME
+@end 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

[-- Attachment #3: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel

Re: doco setlocale

[Kevin Ryde]

I wrote:
>
>         * posix.texi (Locales): Clarify setlocale a bit, list all categories,
>         cross reference to libc.

Since there's no violent objections, I made this change.


_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel