aboutsummaryrefslogtreecommitdiffstats
path: root/chapter06/groff.xml
diff options
context:
space:
mode:
authorJeremy Huntwork <jhuntwork@linuxfromscratch.org>2006-01-06 01:59:08 +0000
committerJeremy Huntwork <jhuntwork@linuxfromscratch.org>2006-01-06 01:59:08 +0000
commitfa21b3dc894b9964620968dfae6685d69ce89fb9 (patch)
tree2353b9af8cae48156b98e651873d483e994e352a /chapter06/groff.xml
parent60e34b52810dd47567ca18aa2c86fe4cd7c9fd01 (diff)
Initial support of UTF-8. Thanks Alexander Patrakov.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7245 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06/groff.xml')
-rw-r--r--chapter06/groff.xml25
1 files changed, 23 insertions, 2 deletions
diff --git a/chapter06/groff.xml b/chapter06/groff.xml
index a2d8cb7e2..db13ad57e 100644
--- a/chapter06/groff.xml
+++ b/chapter06/groff.xml
@@ -28,14 +28,35 @@ Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
<sect2 role="installation">
<title>Installation of Groff</title>
+<para>Apply the patch that adds the <quote>ascii8</quote> and
+<quote>nippon</quote> devices to Groff:</para>
+
+<screen><userinput>zcat ../&groff-debian-patch; | patch -Np1</userinput></screen>
+
+<note><para>These devices are used by Man-DB when formatting non-English manual
+pages that are not in the ISO-8859-1 encoding. Currently, there is no working
+patch for Groff-1.19.x that adds this functionality.
+<!-- Details: http://bugs.debian.org/196762 -->
+</para></note>
+
+<para>Many screen fonts don't have Unicode single quotes and dashes in them.
+Tell Groff to use the ASCII equivalents instead:</para>
+
+<screen><userinput>sed -i -e 's/2010/002D/' -e 's/2212/002D/' \
+ -e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto
+</userinput></screen>
+
<para>Groff expects the environment variable <envar>PAGE</envar>
to contain the default paper size. For users in the United States,
<parameter>PAGE=letter</parameter> is appropriate. Elsewhere,
-<parameter>PAGE=A4</parameter> may be more suitable.</para>
+<parameter>PAGE=A4</parameter> may be more suitable.
+While the default paper size is configured during compilation, it can be
+overridden later by echoing either <quote>A4</quote> or <quote>letter</quote>
+to the <filename>/etc/papersize</filename> file.</para>
<para>Prepare Groff for compilation:</para>
-<screen><userinput>PAGE=<replaceable>[paper_size]</replaceable> ./configure --prefix=/usr</userinput></screen>
+<screen><userinput>PAGE=<replaceable>[paper_size]</replaceable> ./configure --prefix=/usr --enable-multibyte</userinput></screen>
<para>Compile the package:</para>