$LANG and $LANGUAGE not documented in locale manual page

[Kalman Noel]

Binary package hint: belocs-locales-bin

'locale' prints not only the values of LC_*, but also LANG and LANGUAGE. These variables should be appropriately documented in the manpage.

[Rolf Leggewie (r0lf)]

"man 3 gettext" has some information about the LANGUAGE variable. The locale stuff is pretty complicated and I was thankful for some explanations I received from Ralf Doering in bug 190193. I found that http://www.linux.com/feature/53781 explains the subject pretty well.

[Rolf Leggewie (r0lf)]

I just commented on the related bug 872343

"documentation of the meaning and hierarchy of LANG, LANGUAGE and LC_ is scattered across a number of places which I agree is unfortunate. [...] I'd think that having it documented in only one place and have other manpages refer to that places would be the way to go."

Maybe we can prepare a list of where this stuff is currently documented.

man 1 locale
man 3 gettext
man 3 setlocale

[Stéphane Aulery (lkppo)]

It's also in

man 7 environ

[Stéphane Aulery (lkppo)]

Hi,

It would be nice to have the manpage of setlocale updated to declare that the env variable "LANGUAGE" will be read to get the language.
It should also state that the variable LANGUAGE will be the first one (before LC_ALL or LANG).

Thanks.
For the record, the bug #700213 describes a problem about that.

[This comment is merged from Bug #872343, which is more or less a duplicate.]

[Michael Kerrisk (mtk-manpages)]

In reply to the initial report:

> 'locale' prints not only the values of LC_*, but also LANG and LANGUAGE.

Does it really do this on Ubuntu? On my Fedora system, locale(1) displays LANG, but not LANGUAGE. This is consistent with the fact that LANGUAGE is gettext-specific, as I understand it.

[Michael Kerrisk (mtk-manpages)]

Hi Stéphane.

See my reply into the bug. The reporter is confused. AFAIK,
setlocale() ignores LANGUAGE.

Cheers,

Michael

On 17 February 2016 at 00:51, Stéphane Aulery <email address hidden> wrote:
> Hi,
>
> It would be nice to have the manpage of setlocale updated to declare that the env variable "LANGUAGE" will be read to get the language.
> It should also state that the variable LANGUAGE will be the first one (before LC_ALL or LANG).
>
> Thanks.
> For the record, the bug #700213 describes a problem about that.
>
> [This comment is merged from Bug #872343, which is more or less a
> duplicate.]
>
> --
> You received this bug notification because you are subscribed to
> manpages in Ubuntu.
> Matching subscriptions: mk-manpages
> https://bugs.launchpad.net/bugs/311558
>
> Title:
> $LANG and $LANGUAGE not documented in locale manual page
>
> Status in eglibc package in Ubuntu:
> Triaged
> Status in manpages package in Ubuntu:
> New
>
> Bug description:
> Binary package hint: belocs-locales-bin
>
> 'locale' prints not only the values of LC_*, but also LANG and
> LANGUAGE. These variables should be appropriately documented in the
> manpage.
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/ubuntu/+source/eglibc/+bug/311558/+subscriptions

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/

[Stéphane Aulery (lkppo)]

Really, I was too tired to do that yesterday. Should we not close the bug and open another one with a title and an appropriate description?

[Rolf Leggewie (r0lf)]

> In reply to the initial report:
>
> > 'locale' prints not only the values of LC_*, but also LANG and LANGUAGE.
>
> Does it really do this on Ubuntu?

Yes, it does.

$ locale
LANG=de_DE.UTF-8
LANGUAGE="de:en:jp"
LC_CTYPE="de_DE.UTF-8"
LC_NUMERIC=de_DE.UTF-8
LC_TIME=de_DE.UTF-8
LC_COLLATE="de_DE.UTF-8"
LC_MONETARY=de_DE.UTF-8
LC_MESSAGES=C
LC_PAPER=de_DE.UTF-8
LC_NAME=de_DE.UTF-8
LC_ADDRESS=de_DE.UTF-8
LC_TELEPHONE=de_DE.UTF-8
LC_MEASUREMENT=de_DE.UTF-8
LC_IDENTIFICATION=de_DE.UTF-8
LC_ALL=

[Michael Kerrisk (mtk-manpages)]

On 21 February 2016 at 13:56, Rolf Leggewie <email address hidden> wrote:
>> In reply to the initial report:
>>
>> > 'locale' prints not only the values of LC_*, but also LANG and LANGUAGE.
>>
>> Does it really do this on Ubuntu?
>
> Yes, it does.
>
> $ locale
> LANG=de_DE.UTF-8
> LANGUAGE="de:en:jp"
> LC_CTYPE="de_DE.UTF-8"
> LC_NUMERIC=de_DE.UTF-8
> LC_TIME=de_DE.UTF-8
> LC_COLLATE="de_DE.UTF-8"
> LC_MONETARY=de_DE.UTF-8
> LC_MESSAGES=C
> LC_PAPER=de_DE.UTF-8
> LC_NAME=de_DE.UTF-8
> LC_ADDRESS=de_DE.UTF-8
> LC_TELEPHONE=de_DE.UTF-8
> LC_MEASUREMENT=de_DE.UTF-8
> LC_IDENTIFICATION=de_DE.UTF-8
> LC_ALL=

Hmmm -- looking at the glibc sources, locale(1) does not appear to
natively do this. I wonder if this a Debiab/Ubuntu specific patch?

[Rolf Leggewie (r0lf)]

FWIW, I am running trusty and libc-bin comes from eglibc there but from glibc source packge in later releases. Maybe that can explain the difference. I currently do not have access to a later Ubuntu release to test what the locale command does there.