Bug#632795: glibc-doc-reference: Information about LANGUAGE is incorrect

[Vincent Lefevre <vincent@vinc17.net>]

Package: glibc-doc-reference
Version: 2.13-1
Severity: normal

The libc manual (libc.info.gz) says:

  8.2.1.6 User influence on `gettext'

  [...]

     The LOCALE component is computed based on the category used.  Just
  like for the `setlocale' function here comes the user selection into
  the play.  Some environment variables are examined in a fixed order and
  the first environment variable set determines the return value of the
  lookup process.  In detail, for the category `LC_xxx' the following
  variables in this order are examined:

  `LANGUAGE'

  `LC_ALL'

  `LC_xxx'

  `LANG'

However, this is incorrect, and the way it is done is more complex,
as shown below:

ypig% LANGUAGE=fr_FR LC_ALL=en_US cp
cp: opérande fichier manquant
Saisissez « cp --help » pour plus d'informations.
ypig% LANGUAGE=fr_FR LC_ALL=C cp    
cp: missing file operand
Try `cp --help' for more information.

According to bug 591334, this is the manual that is incorrect.

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.39-2-amd64 (SMP w/8 CPU cores)
Locale: LANG=POSIX, LC_CTYPE=en_US.ISO8859-1 (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/dash

Versions of packages glibc-doc-reference depends on:
ii  dpkg                      1.16.0.3       Debian package management system
ii  install-info              4.13a.dfsg.1-6 Manage installed documentation in 

glibc-doc-reference recommends no packages.

glibc-doc-reference suggests no packages.

-- no debconf information