aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/man.xml
diff options
context:
space:
mode:
authorZack Winkles <winkie@linuxfromscratch.org>2004-05-06 16:22:04 +0000
committerZack Winkles <winkie@linuxfromscratch.org>2004-05-06 16:22:04 +0000
commitb32e80330973383d4eca995d6193e35a743176cd (patch)
treec657760bd2b5c756d0371c908425ecc5835e90ca /chapter06/man.xml
parent4dc8dc63eef4a0b4e70ffa3ff12d8678a6a81e92 (diff)
Committed Alexander's i18n patch
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3489 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/man.xml')
-rw-r--r--chapter06/man.xml29
1 files changed, 29 insertions, 0 deletions
diff --git a/chapter06/man.xml b/chapter06/man.xml
index a1cf37193..58667a2ca 100644
--- a/chapter06/man.xml
+++ b/chapter06/man.xml
@@ -73,6 +73,35 @@ configuration file in the <filename>/etc</filename> directory.</para></listitem>
<filename>man.conf</filename> file and add the <emphasis>-c</emphasis> switch
to NROFF.</para></note>
+<para>If your character set uses 8-bit characters, search for the line
+beginning with "NROFF" in /etc/man.conf, and verify that it coincides
+with the following:</para>
+
+<screen>NROFF /usr/bin/nroff -Tlatin1 -mandoc</screen>
+
+<para>Note that you should use "latin1" even if it is not the character set
+of your locale. The reason is that,
+according to the specification, <application>groff</application> has
+no means of typesetting characters outside ISO-8859-1
+without some strange escape codes, and localized manual
+pages are therefore really a hack. When formatting manual pages,
+<application>groff</application> thinks that they are in the ISO-8859-1
+encoding and this <emphasis>-Tlatin1</emphasis> switch tells
+<application>groff</application> to use the same encoding for output.
+Since <application>groff</application> does no recoding of input characters,
+the formatted result is really in the same encoding as input (although
+<application>groff</application> doesn't know that it is not ISO-8859-1)
+and therefore it is usable as the input for a pager.</para>
+
+<para>Of course, this hack does not solve the problem of non-working
+<command>man2dvi</command> program for localized manual
+pages in non-ISO-8859-1 locales.
+Also, it does not work at all with multibyte character sets.
+The first problem does not have a solution currently. The second
+one is not of a concern because the LFS installation does not support
+multibyte character sets properly anyway. You may want to look at
+internationalization related hints, though.</para>
+
<para>You may want to also take a look at the BLFS page at
<ulink url="&blfs-root;view/cvs/postlfs/compressdoc.html"/> which deals with
formatting and compression issues for man pages.</para>