public inbox for linux-man@vger.kernel.org
 help / color / mirror / Atom feed
From: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
To: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
Cc: linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Subject: [PATCH] Clarify $LANGUAGE description
Date: Thu, 4 Dec 2008 02:53:26 +0100	[thread overview]
Message-ID: <20081204015326.GS10491@machine.or.cz> (raw)

This patch (against the latest git) attempts to clean up the $LANGUAGE
description, by removing bogus comments from setlocale(3) and expanding
the mention in locale(7).

Maybe you will decide that a more detailed description should be left
to the gettext(3) documentation, but I actually care about the invisible
part of the patch more since the comments have put me off the track
initially ($LANGUAGE has nothing to do with setlocale(3) and is
completely isolated to gettext, as obvious from the glibc sources).

Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>

diff --git a/man3/setlocale.3 b/man3/setlocale.3
index a5d9896..21eebfb 100644
--- a/man3/setlocale.3
+++ b/man3/setlocale.3
@@ -26,6 +26,7 @@
 .\" Modified Sun Jul  4 14:52:16 1999 by Bruno Haible (haible-dhnC2lb7rBJy/B6EtB590w@public.gmane.org)
 .\" Modified Tue Aug 24 17:11:01 1999 by Andries Brouwer (aeb-rh8NL+sEX9E@public.gmane.org)
 .\" Modified Tue Feb  6 03:31:55 2001 by Andries Brouwer (aeb-rh8NL+sEX9E@public.gmane.org)
+.\" Modified Thu Dec  4 02:34:27 2008 by Petr Baudis (pasky-AlSwsSmVLrQ@public.gmane.org)
 .\"
 .TH SETLOCALE 3  1999-07-04 "GNU" "Linux Programmer's Manual"
 .SH NAME
@@ -88,13 +89,7 @@ is
 each part of the locale that should be modified is set according to the
 environment variables.
 The details are implementation-dependent.
-For glibc, first
-.\" [This is false on my system - must check which library versions do this]
-.\" if
-.\" .I category
-.\" is LC_MESSAGES, the environment variable LANGUAGE is inspected,
-.\" then
-(regardless of
+For glibc, first (regardless of
 .IR category ),
 the environment variable
 .B LC_ALL
@@ -113,8 +108,6 @@ If its value is not a valid locale specification, the locale
 is unchanged, and
 .BR setlocale ()
 returns NULL.
-.\" The environment variable LANGUAGE may contain several, colon-separated,
-.\" locale names.
 .PP
 The locale
 .B """C"""
diff --git a/man7/locale.7 b/man7/locale.7
index 3da0ed7..8236e0f 100644
--- a/man7/locale.7
+++ b/man7/locale.7
@@ -24,6 +24,7 @@
 .\" Modified Sun Jun 01 17:16:34 1997 by Jochen Hein
 .\"   <jochen.hein-JaLWT6YIeqAVwOsi8Avp+rNAH6kLmebB@public.gmane.org>
 .\" Modified Thu Apr 25 00:43:19 2002 by Bruno Haible <bruno-nWNVUoHt2MvYtjvyW6yDsg@public.gmane.org>
+.\" Modified Thu Dec  4 02:34:27 2008 by Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
 .\"
 .TH LOCALE 7  1993-04-24 "Linux" "Linux Programmer's Manual"
 .SH NAME
@@ -98,7 +99,10 @@ and
 functions to ease the use of these information.
 The GNU gettext family of
 functions also obey the environment variable
-.BR LANGUAGE .
+.BR LANGUAGE
+(containing a colon-separated list of locales)
+if the category is set to a valid locale other than
+.BR """C""" .
 .TP
 .B LC_NUMERIC
 changes the information used by the
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

             reply	other threads:[~2008-12-04  1:53 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-12-04  1:53 Petr Baudis [this message]
     [not found] ` <20081204015326.GS10491-DDGJ70k9y3lX+M3pkMnKjw@public.gmane.org>
2008-12-05 23:33   ` [PATCH] Clarify $LANGUAGE description Michael Kerrisk

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20081204015326.GS10491@machine.or.cz \
    --to=pasky-alswssmvlrq@public.gmane.org \
    --cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox