diff options
Diffstat (limited to 'chapter06/groff.xml')
| -rw-r--r-- | chapter06/groff.xml | 25 |
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> |