Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 116850 - unreadable character output for man-pages-ru due to illegal nroff parameter in man.conf
Summary: unreadable character output for man-pages-ru due to illegal nroff parameter i...
Status: RESOLVED WORKSFORME
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Localisation Guide (show other bugs)
Hardware: All Linux
: High trivial (vote)
Assignee: Alexey Chumakov (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-12-27 01:15 UTC by Vladimir Dolzhenko
Modified: 2006-03-04 03:13 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Vladimir Dolzhenko 2005-12-27 01:15:09 UTC
in /etc/man.pages 
NROFF           /usr/bin/nroff -Tascii -c -mandoc
that why man is unreadable for localized man pages.
must be use there
NROFF           /usr/bin/nroff -Tlatin1 -c -mandoc

and check for other localized man pages
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2005-12-27 02:48:01 UTC
Huh, illegal?

<snip>
case "`exec 2>/dev/null ; locale charmap`" in
  UTF-8)
    T=-Tutf8 ;;
  ISO-8859-1)
    T=-Tlatin1 ;;
  IBM-1047)
    T=-Tcp1047 ;;
  *)
</snip>

The default value is just fine for en_US; if you are using UTF-8 then it's covered by http://www.gentoo.org/doc/en/utf-8.xml#doc_chap2, if you are using something else then ask the translators to document this in http://www.gentoo.org/doc/ru/guide-localization.xml.

Not a man bug.
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2005-12-27 02:52:22 UTC
man nroff

<snip>
The nroff script emulates the nroff command using groff. Only ascii, latin1, utf8, and cp1047 are valid arguments for the -T option, selecting the output encoding emitted by grotty, groff's TTY output device. If  an  invalid  or  no  -T option is given, nroff checks the current locale to select a default output device.  It first tries the locale program, then the environment variables LC_ALL, LC_CTYPE, and LANG, and finally the LESSCHARSET environment variable.
</snip>
Comment 3 Vladimir Dolzhenko 2005-12-29 02:20:16 UTC
well, if there is 
NROFF           /usr/bin/nroff -Tascii -c -mandoc
in /etc/man.conf when there is no matter to values of LC_ALL, LC_CTYPE, and LANG, and finally the LESSCHARSET. If there is 
NROFF           /usr/bin/nroff -c -mandoc
(no -Tascii) in /etc/man.conf and when
$ LESSCHARSET="latin1" man ls
works fine.

In case of KOI8-R locale -T option mustn't be used or used latin1.
Comment 4 Jakub Moc (RETIRED) gentoo-dev 2006-03-04 03:13:56 UTC
(In reply to comment #3)
> In case of KOI8-R locale -T option mustn't be used or used latin1.

So set it as you need, there's no illegal parameter in there.