Debian Bug report logs - #638186
locale(1) and locale(5) should describe LANG and LANGUAGE

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Gioele Barabucci <gioele@svario.it>

To: submit@bugs.debian.org, mtk.manpages@gmail.com

Cc: linux-man@vger.kernel.org

Subject: locale({1,5}) should describe LANG and LANGUAGE

Date: Wed, 17 Aug 2011 16:18:03 +0200

Package: manpages
Version: 3.23

The man page for `locale(1)` do not describe the LANG and LANGUAGE 
environment variables. `environ(7)` describes only LANG and refers to 
`locale(5)` for further explaination. `locale(5)` do not describe 
neither LANG or LANGUAGE.

Both LANG and LANGUAGE are described in LSB 4.0, although not in depth.

Shouldn't the meaning and the format of LANG and LANGUAGE and the 
difference between these two environment variables be explained in 
`locale` manpages?

Regards,

-- 
Gioele Barabucci <gioele@svario.it>

Message #12 received at 638186@bugs.debian.org (full text, mbox, reply):

From: Simon Paillard <spaillard@debian.org>

To: Gioele Barabucci <gioele@svario.it>, 638186@bugs.debian.org

Subject: Re: Bug#638186: locale({1,5}) should describe LANG and LANGUAGE

Date: Fri, 17 Jan 2014 23:13:58 +0100

Control: -1 retitle locale(5) should describe LANG and LANGUAGE

Hi,

On Wed, Aug 17, 2011 at 04:18:03PM +0200, Gioele Barabucci wrote:
> Package: manpages
> Version: 3.23
> 
> The man page for `locale(1)` do not describe the LANG and LANGUAGE
> environment variables.

Note locale(1) is not from manpages package:
libc-bin: /usr/share/man/man1/locale.1.gz

> `environ(7)` describes only LANG and refers to `locale(5)` for further
> explaination. `locale(5)` do not describe neither LANG or LANGUAGE.
> 
> Both LANG and LANGUAGE are described in LSB 4.0, although not in depth.
> 
> Shouldn't the meaning and the format of LANG and LANGUAGE and the
> difference between these two environment variables be explained in
> `locale` manpages?
 

-- 
Simon Paillard

Message #17 received at 638186@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>

To: 638186@bugs.debian.org

Cc: Gioele Barabucci <gioele@svario.it>

Subject: Re: Bug#638186: locale({1,5}) should describe LANG and LANGUAGE

Date: Sat, 18 Jan 2014 22:51:09 +1300

LANG and LANGUAGE certainly *are* described in the upstream locale(5) page....

On Sat, Jan 18, 2014 at 11:13 AM, Simon Paillard <spaillard@debian.org> wrote:
> Control: -1 retitle locale(5) should describe LANG and LANGUAGE
>
> Hi,
>
> On Wed, Aug 17, 2011 at 04:18:03PM +0200, Gioele Barabucci wrote:
>> Package: manpages
>> Version: 3.23
>>
>> The man page for `locale(1)` do not describe the LANG and LANGUAGE
>> environment variables.
>
> Note locale(1) is not from manpages package:
> libc-bin: /usr/share/man/man1/locale.1.gz
>
>> `environ(7)` describes only LANG and refers to `locale(5)` for further
>> explaination. `locale(5)` do not describe neither LANG or LANGUAGE.
>>
>> Both LANG and LANGUAGE are described in LSB 4.0, although not in depth.
>>
>> Shouldn't the meaning and the format of LANG and LANGUAGE and the
>> difference between these two environment variables be explained in
>> `locale` manpages?
>
>
> --
> Simon Paillard
>



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

Message #22 received at 638186@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>

To: 638186 <638186@bugs.debian.org>

Cc: Gioele Barabucci <gioele@svario.it>

Subject: Re: Bug#638186: locale({1,5}) should describe LANG and LANGUAGE

Date: Sat, 18 Jan 2014 22:53:14 +1300

My apologies. They are described in the *locale(7)* page.

On Sat, Jan 18, 2014 at 10:51 PM, Michael Kerrisk (man-pages)
<mtk.manpages@gmail.com> wrote:
> LANG and LANGUAGE certainly *are* described in the upstream locale(5) page....
>
> On Sat, Jan 18, 2014 at 11:13 AM, Simon Paillard <spaillard@debian.org> wrote:
>> Control: -1 retitle locale(5) should describe LANG and LANGUAGE
>>
>> Hi,
>>
>> On Wed, Aug 17, 2011 at 04:18:03PM +0200, Gioele Barabucci wrote:
>>> Package: manpages
>>> Version: 3.23
>>>
>>> The man page for `locale(1)` do not describe the LANG and LANGUAGE
>>> environment variables.
>>
>> Note locale(1) is not from manpages package:
>> libc-bin: /usr/share/man/man1/locale.1.gz
>>
>>> `environ(7)` describes only LANG and refers to `locale(5)` for further
>>> explaination. `locale(5)` do not describe neither LANG or LANGUAGE.
>>>
>>> Both LANG and LANGUAGE are described in LSB 4.0, although not in depth.
>>>
>>> Shouldn't the meaning and the format of LANG and LANGUAGE and the
>>> difference between these two environment variables be explained in
>>> `locale` manpages?
>>
>>
>> --
>> Simon Paillard
>>
>
>
>
> --
> Michael Kerrisk
> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
> Linux/UNIX System Programming Training: http://man7.org/training/



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

Message #27 received at 638186@bugs.debian.org (full text, mbox, reply):

From: "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>

To: 638186 <638186@bugs.debian.org>, control@bugs.debian.org

Cc: Gioele Barabucci <gioele@svario.it>

Subject: Re: Bug#638186: locale({1,5}) should describe LANG and LANGUAGE

Date: Sat, 18 Jan 2014 23:16:32 +1300

tags 638186 fixed-upstream
thanks

So, I've added locale(7) in the SEE ALSO references of locale(5) and
environ(7). Note that locale(5) describes a FILE, while locale(7)
describes environment variables. I also applied the diff below to
environ(7). I believe this is sufficient to address the problem. If
not, let me know.

Cheers,

Michael

diff --git a/man7/environ.7 b/man7/environ.7
index 4a0f38f..2864b04 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -31,7 +31,7 @@
 .\" Modified Wed Jan 24 06:37:24 2001 by Eric S. Raymond (esr@thyrsus.com)
 .\" Modified Thu Dec 13 23:53:27 2001 by Martin Schulze <joey@infodrom.org>
 .\"
-.TH ENVIRON 7 2009-07-25 "Linux" "Linux Programmer's Manual"
+.TH ENVIRON 7 2014-01-18 "Linux" "Linux Programmer's Manual"
 .SH NAME
 environ \- user environment
 .SH SYNOPSIS
@@ -76,15 +76,19 @@ from the password file
 The name of a locale to use for locale categories when not overridden
 by
 .B LC_ALL
-or more specific environment variables like
+or more specific environment variables such as
 .BR LC_COLLATE ,
 .BR LC_CTYPE ,
 .BR LC_MESSAGES ,
 .BR LC_MONETARY ,
 .BR LC_NUMERIC ,
-.BR LC_TIME ,
-cf.
-.BR locale (5).
+and
+.BR LC_TIME
+(see
+.BR locale (7)
+for further details of the
+.BR LC_*
+environment variables).
 .TP
 .B PATH
 The sequence of directory prefixes that
@@ -146,8 +150,11 @@ A random collection:
 The variables
 .BR LANG ", " LANGUAGE ", " NLSPATH ", " LOCPATH ", "
 .BR LC_ALL ", " LC_MESSAGES ", "
-etc. influence locale handling, cf.
-.BR locale (5).
+and so on influence locale handling; see
+.BR catopen (3),
+.BR gettext (3),
+and
+.BR locale (7).
 .LP
 .B TMPDIR
 influences the path prefix of names created by
@@ -251,4 +258,4 @@ should consider renaming their option to
 .BR putenv (3),
 .BR setenv (3),
 .BR unsetenv (3),
-.BR locale (5)
+.BR locale (7)

On Sat, Jan 18, 2014 at 10:53 PM, Michael Kerrisk (man-pages)
<mtk.manpages@gmail.com> wrote:
> My apologies. They are described in the *locale(7)* page.
>
> On Sat, Jan 18, 2014 at 10:51 PM, Michael Kerrisk (man-pages)
> <mtk.manpages@gmail.com> wrote:
>> LANG and LANGUAGE certainly *are* described in the upstream locale(5) page....
>>
>> On Sat, Jan 18, 2014 at 11:13 AM, Simon Paillard <spaillard@debian.org> wrote:
>>> Control: -1 retitle locale(5) should describe LANG and LANGUAGE
>>>
>>> Hi,
>>>
>>> On Wed, Aug 17, 2011 at 04:18:03PM +0200, Gioele Barabucci wrote:
>>>> Package: manpages
>>>> Version: 3.23
>>>>
>>>> The man page for `locale(1)` do not describe the LANG and LANGUAGE
>>>> environment variables.
>>>
>>> Note locale(1) is not from manpages package:
>>> libc-bin: /usr/share/man/man1/locale.1.gz
>>>
>>>> `environ(7)` describes only LANG and refers to `locale(5)` for further
>>>> explaination. `locale(5)` do not describe neither LANG or LANGUAGE.
>>>>
>>>> Both LANG and LANGUAGE are described in LSB 4.0, although not in depth.
>>>>
>>>> Shouldn't the meaning and the format of LANG and LANGUAGE and the
>>>> difference between these two environment variables be explained in
>>>> `locale` manpages?
>>>
>>>
>>> --
>>> Simon Paillard
>>>
>>
>>
>>
>> --
>> Michael Kerrisk
>> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
>> Linux/UNIX System Programming Training: http://man7.org/training/
>
>
>
> --
> Michael Kerrisk
> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
> Linux/UNIX System Programming Training: http://man7.org/training/



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

Message #34 received at 638186-close@bugs.debian.org (full text, mbox, reply):

From: Simon Paillard <spaillard@debian.org>

To: 638186-close@bugs.debian.org

Subject: Bug#638186: fixed in manpages 3.57-1

Date: Mon, 03 Feb 2014 21:50:24 +0000

Source: manpages
Source-Version: 3.57-1

We believe that the bug you reported is fixed in the latest version of
manpages, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 638186@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Simon Paillard <spaillard@debian.org> (supplier of updated manpages package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Mon, 03 Feb 2014 22:04:08 +0100
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 3.57-1
Distribution: unstable
Urgency: medium
Maintainer: Martin Schulze <joey@debian.org>
Changed-By: Simon Paillard <spaillard@debian.org>
Description: 
 manpages   - Manual pages about using a GNU/Linux system
 manpages-dev - Manual pages about using GNU/Linux for development
Closes: 574370 638186 735590
Changes: 
 manpages (3.57-1) unstable; urgency=medium
 .
   * Imported Upstream version 3.57
     . select.2: RETURN VALUE: Fix discussion of treatment of file descriptor
       (Closes: #574370)
     . environ.7: Correct reference to locale(7) (not locale(5))
       (Closes: #638186)
     . filesystems.5: Add reference to proc(5) for more details on
       /proc/filesystems (Closes: #735590)
   * debian/control: Bump Standards-Version to 3.9.5
Checksums-Sha1: 
 62c6a1a03c99e9c007bb07b71ab3907e6e2bfeb4 1916 manpages_3.57-1.dsc
 e83f68f77dcc14d2c060fc6ef66c5f65ca78fb65 1195700 manpages_3.57.orig.tar.xz
 df463ab150efedf86a70ea8bb6ec8e3ae14cbc99 42408 manpages_3.57-1.debian.tar.xz
 d88ce40a0f0cff3819491c62f3d5ee3608e71d52 879012 manpages_3.57-1_all.deb
 4f49aec85b9e41b6b0ec645c34e16de8ffdbefaa 1805336 manpages-dev_3.57-1_all.deb
Checksums-Sha256: 
 81af875912bad5b88447713b49292f944a1602de1c4041be675f81d54a64e141 1916 manpages_3.57-1.dsc
 910ba04a792fe5769957d91701066e57ce6e9ff7f2ea6479ff3f2cde147706e5 1195700 manpages_3.57.orig.tar.xz
 f051ab71af2368723d49a9a83472f8ea6ced2bef9d59968ea38976d57ac70dc2 42408 manpages_3.57-1.debian.tar.xz
 973afd65d6336a9df34500d1158cb615e9e19da2c67d31afe59bb889223d1a39 879012 manpages_3.57-1_all.deb
 21f0a4232487fc1f2666e00d153c1c2fcae8bb828e19b620cb55d7e10141f35f 1805336 manpages-dev_3.57-1_all.deb
Files: 
 523fdb7d855a8b4b092364d952bf0be2 1916 doc important manpages_3.57-1.dsc
 18bba89745fecdfddad3caaef7cde5f4 1195700 doc important manpages_3.57.orig.tar.xz
 0f1cbd6c95bda4a6111da2018af7f8cf 42408 doc important manpages_3.57-1.debian.tar.xz
 661f9a97ab19190dd238470185bd1a4a 879012 doc important manpages_3.57-1_all.deb
 d0d08b16e602ac722556ff37cea94991 1805336 doc optional manpages-dev_3.57-1_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCAAGBQJS8AevAAoJEN/3OMLRbPuiGJYP/3WGMg59nXhDcd4OTtT0utOb
ppwhPHC5qcuW2gJl7rrmMvHbJlxE9qCG5jHpqETjz7m1cBRnMitOifTJGY0limEC
NYxz+x6G0w1cCsvBeSDnmeB2Cr2X3Q0uiI6dcFseaz4oRk43D3J79GsyaeoBera+
jjpXiRetagD0bhnHmf0W3ADSzH50+4EIuTgpO9M7NN2SWo1MyvImPgbYadNYAU/d
jU3GlEJWuJroJZpAg+15PUNEzBhlf+5sSdlPo/m0arVrd0w/NRSpaxgtawF8fSl0
nqpEUE3STpvONuClyYeSu8z+F+CTVyVk9UWpfAAkRSXU+ltQvSNje1ZqVQGv3AUJ
or4/9IztgXoX+jKlLyQr/dAYxyxEgkmXBQql9K5irE5spXCdtissDY4msRT+FBys
qxFxVCKVL5vPYCNpPP/moIX5Mn2jsLtqpjuZffdkGwyQhctGinqQIJ0Cx/OCdCBc
cs9mK09zRlCTCU2tri3AJ9FHnzbFcNRfAiT/5V3BEZBFp/D2Q+GD7ovFN+0GSCxt
mH+rSlb4qJHoRuHivlDIEtMamvkT+i1FoByjqRWcCHntl02hDGQ/HfJChsYJ6Zrn
9JzCz0I863mnliXhG0yepLbmxd6q972P64QhCl8osiVv55qmBiyCWD1DtnbcaPDg
s+ZaH0YRdVNyKqIWnvEf
=BzYG
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.