source: chapter06/groff.xml@ 456a1d92

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.0 6.1 6.1.1 6.3 6.4 6.5 6.6 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 456a1d92 was b8a819f, checked in by Manuel Canales Esparcia <manuel@…>, 20 years ago

Changed the id's location in the Short descriptions sections to fix a bug in the PDF generation.

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3711 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 12.1 KB
RevLine 
[673b0d8]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
3 <!ENTITY % general-entities SYSTEM "../general.ent">
4 %general-entities;
5]>
[a001133]6<sect1 id="ch-system-groff" xreflabel="Groff" role="wrap">
[673b0d8]7<title>Groff-&groff-version;</title>
8<?dbhtml filename="groff.html"?>
9
10<indexterm zone="ch-system-groff"><primary sortas="a-Groff">Groff</primary></indexterm>
[6370fa6]11
[a001133]12<sect2 role="package"><title/>
[5888299]13<para>The Groff package contains programs for processing and formatting text.</para>
14
[a001133]15<segmentedlist>
16<segtitle>&buildtime;</segtitle>
17<segtitle>&diskspace;</segtitle>
18<seglistitem><seg>0.5 SBU</seg><seg>43 MB</seg></seglistitem>
19</segmentedlist>
20
21<segmentedlist>
22<segtitle>Groff installation depends on</segtitle>
23<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
24Gawk, GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
25</segmentedlist>
26</sect2>
[73aedd1d]27
[a001133]28<sect2 role="installation">
[73aedd1d]29<title>Installation of Groff</title>
30
31<para>Groff expects the environment variable PAGE to contain the default paper
[17476c5]32size. For those in the United States, the command below is appropriate. If you
[73aedd1d]33live elsewhere, you may want to change <emphasis>PAGE=letter</emphasis> to
34<emphasis>PAGE=A4</emphasis>.</para>
35
36<para>Prepare Groff for compilation:</para>
37
38<screen><userinput>PAGE=letter ./configure --prefix=/usr</userinput></screen>
39
40<para>Compile the package:</para>
41
42<screen><userinput>make</userinput></screen>
43
[673b0d8]44<para>Now install it:</para>
[73aedd1d]45
46<screen><userinput>make install</userinput></screen>
47
[90e3cb3]48<para>Some documentation programs, such as <command>xman</command>,
[16cc39b]49will not work properly without the following symlinks:</para>
[73aedd1d]50
51<screen><userinput>ln -s soelim /usr/bin/zsoelim
52ln -s eqn /usr/bin/geqn
53ln -s tbl /usr/bin/gtbl</userinput></screen>
54
55</sect2>
[6370fa6]56
[5888299]57
[c6cb3aa]58<sect2 id="contents-groff" role="content"><title>Contents of Groff</title>
[673b0d8]59
[c6cb3aa]60<segmentedlist>
61<segtitle>Installed programs</segtitle>
[b8a819f]62<seglistitem><seg>addftinfo, afmtodit, eqn, eqn2graph, geqn (link to eqn), grn,
63grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl (link to tbl), hpftodit,
[c6cb3aa]64indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml,
65pre-grohtml, refer, soelim, tbl, tfmtodit, troff and zsoelim (link to soelim)</seg></seglistitem>
66</segmentedlist>
[673b0d8]67
[c6cb3aa]68<variablelist><title>Short descriptions</title>
[673b0d8]69
[b8a819f]70<varlistentry id="addftinfo">
71<term><command>addftinfo</command></term>
[c6cb3aa]72<listitem>
[673b0d8]73<indexterm zone="ch-system-groff addftinfo"><primary sortas="b-addftinfo">addftinfo</primary></indexterm>
[c6cb3aa]74<para>reads a troff font file and adds some
[673b0d8]75additional font-metric information that is used by the groff system.</para>
[c6cb3aa]76</listitem>
77</varlistentry>
[673b0d8]78
[b8a819f]79<varlistentry id="afmtodit">
80<term><command>afmtodit</command></term>
[c6cb3aa]81<listitem>
[673b0d8]82<indexterm zone="ch-system-groff afmtodit"><primary sortas="b-afmtodit">afmtodit</primary></indexterm>
[c6cb3aa]83<para>creates a font file for use with groff and grops.</para>
84</listitem>
85</varlistentry>
[673b0d8]86
[b8a819f]87<varlistentry id="eqn">
88<term><command>eqn</command></term>
[c6cb3aa]89<listitem>
[673b0d8]90<indexterm zone="ch-system-groff eqn"><primary sortas="b-eqn">eqn</primary></indexterm>
[c6cb3aa]91<para>compiles descriptions of equations embedded
[673b0d8]92within troff input files into commands that are understood by troff.</para>
[c6cb3aa]93</listitem>
94</varlistentry>
[673b0d8]95
[b8a819f]96<varlistentry id="eqn2graph">
97<term><command>eqn2graph</command></term>
[c6cb3aa]98<listitem>
[673b0d8]99<indexterm zone="ch-system-groff eqn2graph"><primary sortas="b-eqn2graph">eqn2graph</primary></indexterm>
[c6cb3aa]100<para>converts an EQN equation into a cropped image.</para>
101</listitem>
102</varlistentry>
[673b0d8]103
[b8a819f]104<varlistentry id="grn">
105<term><command>grn</command></term>
[c6cb3aa]106<listitem>
[673b0d8]107<indexterm zone="ch-system-groff grn"><primary sortas="b-grn">grn</primary></indexterm>
[c6cb3aa]108<para>is a groff preprocessor for gremlin files.</para>
109</listitem>
110</varlistentry>
[673b0d8]111
[b8a819f]112<varlistentry id="grodvi">
113<term><command>grodvi</command></term>
[c6cb3aa]114<listitem>
[673b0d8]115<indexterm zone="ch-system-groff grodvi"><primary sortas="b-grodvi">grodvi</primary></indexterm>
[c6cb3aa]116<para>is a driver for groff that produces TeX dvi format.</para>
117</listitem>
118</varlistentry>
[673b0d8]119
[b8a819f]120<varlistentry id="groff">
121<term><command>groff</command></term>
[c6cb3aa]122<listitem>
[673b0d8]123<indexterm zone="ch-system-groff groff"><primary sortas="b-groff">groff</primary></indexterm>
[c6cb3aa]124<para>is a front-end to the groff document
[673b0d8]125formatting system. Normally it runs the troff program and a post-processor
126appropriate for the selected device.</para>
[c6cb3aa]127</listitem>
128</varlistentry>
[673b0d8]129
[b8a819f]130<varlistentry id="groffer">
131<term><command>groffer</command></term>
[c6cb3aa]132<listitem>
[673b0d8]133<indexterm zone="ch-system-groff groffer"><primary sortas="b-groffer">groffer</primary></indexterm>
[c6cb3aa]134<para>displays groff files and man pages on X and tty terminals.</para>
135</listitem>
136</varlistentry>
[673b0d8]137
[b8a819f]138<varlistentry id="grog">
139<term><command>grog</command></term>
[c6cb3aa]140<listitem>
[673b0d8]141<indexterm zone="ch-system-groff grog"><primary sortas="b-grog">grog</primary></indexterm>
[c6cb3aa]142<para>reads files and guesses which of the groff
[673b0d8]143options -e, -man, -me, -mm, -ms, -p, -s, and -t are required for printing
144files, and reports the groff command including those options.</para>
[c6cb3aa]145</listitem>
146</varlistentry>
[673b0d8]147
[b8a819f]148<varlistentry id="grolbp">
149<term><command>grolbp</command></term>
[c6cb3aa]150<listitem>
[673b0d8]151<indexterm zone="ch-system-groff grolbp"><primary sortas="b-grolbp">grolbp</primary></indexterm>
[c6cb3aa]152<para>is a groff driver for Canon CAPSL printers
[673b0d8]153(LBP-4 and LBP-8 series laser printers).</para>
[c6cb3aa]154</listitem>
155</varlistentry>
[673b0d8]156
[b8a819f]157<varlistentry id="grolj4">
158<term><command>grolj4</command></term>
[c6cb3aa]159<listitem>
[673b0d8]160<indexterm zone="ch-system-groff grolj4"><primary sortas="b-grolj4">grolj4</primary></indexterm>
[c6cb3aa]161<para>is a driver for groff that produces output
[673b0d8]162in PCL5 format suitable for an HP Laserjet 4 printer.</para>
[c6cb3aa]163</listitem>
164</varlistentry>
[673b0d8]165
[b8a819f]166<varlistentry id="grops">
167<term><command>grops</command></term>
[c6cb3aa]168<listitem>
[673b0d8]169<indexterm zone="ch-system-groff grops"><primary sortas="b-grops">grops</primary></indexterm>
[c6cb3aa]170<para>translates the output of GNU troff to Postscript.</para>
171</listitem>
172</varlistentry>
[6370fa6]173
[b8a819f]174<varlistentry id="grotty">
175<term><command>grotty</command></term>
[c6cb3aa]176<listitem>
[673b0d8]177<indexterm zone="ch-system-groff grotty"><primary sortas="b-grotty">grotty</primary></indexterm>
[c6cb3aa]178<para>translates the output of GNU troff into
[673b0d8]179a form suitable for typewriter-like devices.</para>
[c6cb3aa]180</listitem>
181</varlistentry>
[673b0d8]182
[b8a819f]183<varlistentry id="gtbl">
184<term><command>gtbl</command></term>
[c6cb3aa]185<listitem>
[673b0d8]186<indexterm zone="ch-system-groff gtbl"><primary sortas="b-gtbl">gtbl</primary></indexterm>
[c6cb3aa]187<para>is the GNU implementation of tbl.</para>
188</listitem>
189</varlistentry>
[673b0d8]190
[b8a819f]191<varlistentry id="hpftodit">
192<term><command>hpftodit</command></term>
[c6cb3aa]193<listitem>
[673b0d8]194<indexterm zone="ch-system-groff hpftodit"><primary sortas="b-hpftodit">hpftodit</primary></indexterm>
[c6cb3aa]195<para>creates a font file for use with
[673b0d8]196groff -Tlj4 from an HP-tagged font metric file.</para>
[c6cb3aa]197</listitem>
198</varlistentry>
[673b0d8]199
[b8a819f]200<varlistentry id="indxbib">
201<term><command>indxbib</command></term>
[c6cb3aa]202<listitem>
[673b0d8]203<indexterm zone="ch-system-groff indxbib"><primary sortas="b-indxbib">indxbib</primary></indexterm>
[c6cb3aa]204<para>makes an inverted index for the bibliographic databases a specified file for
205use with refer, lookbib, and lkbib.</para>
206</listitem>
207</varlistentry>
208
[b8a819f]209<varlistentry id="lkbib">
210<term><command>lkbib</command></term>
[c6cb3aa]211<listitem>
[673b0d8]212<indexterm zone="ch-system-groff lkbib"><primary sortas="b-lkbib">lkbib</primary></indexterm>
[c6cb3aa]213<para>searches bibliographic databases for
[673b0d8]214references that contain specified keys and reports any references found.</para>
[c6cb3aa]215</listitem>
216</varlistentry>
[673b0d8]217
[b8a819f]218<varlistentry id="lookbib">
219<term><command>lookbib</command></term>
[c6cb3aa]220<listitem>
[673b0d8]221<indexterm zone="ch-system-groff lookbib"><primary sortas="b-lookbib">lookbib</primary></indexterm>
[c6cb3aa]222<para>prints a prompt on the standard error
[673b0d8]223(unless the standard input is not a terminal), reads from the standard input
224a line containing a set of keywords, searches the bibliographic databases in
225a specified file for references containing those keywords, prints any
226references found on the standard output and repeats this process until the
227end of input.</para>
[c6cb3aa]228</listitem>
229</varlistentry>
[673b0d8]230
[b8a819f]231<varlistentry id="mmroff">
232<term><command>mmroff</command></term>
[c6cb3aa]233<listitem>
[673b0d8]234<indexterm zone="ch-system-groff mmroff"><primary sortas="b-mmroff">mmroff</primary></indexterm>
[c6cb3aa]235<para>is a simple preprocessor for groff.</para>
236</listitem>
237</varlistentry>
[673b0d8]238
[b8a819f]239<varlistentry id="neqn">
240<term><command>neqn</command></term>
[c6cb3aa]241<listitem>
[673b0d8]242<indexterm zone="ch-system-groff neqn"><primary sortas="b-neqn">neqn</primary></indexterm>
[c6cb3aa]243<para>formats equations for ASCII (American Standard Code for Information
244Interchange) output.</para>
245</listitem>
246</varlistentry>
247
[b8a819f]248<varlistentry id="nroff">
249<term><command>nroff</command></term>
[c6cb3aa]250<listitem>
[673b0d8]251<indexterm zone="ch-system-groff nroff"><primary sortas="b-nroff">nroff</primary></indexterm>
[c6cb3aa]252<para>is a script that emulates the nroff command using groff.</para>
253</listitem>
254</varlistentry>
[673b0d8]255
[b8a819f]256<varlistentry id="pfbtops">
257<term><command>pfbtops</command></term>
[c6cb3aa]258<listitem>
[673b0d8]259<indexterm zone="ch-system-groff pfbtops"><primary sortas="b-pfbtops">pfbtops</primary></indexterm>
[c6cb3aa]260<para>translates a Postscript font in .pfb format to ASCII.</para>
261</listitem>
262</varlistentry>
[673b0d8]263
[b8a819f]264<varlistentry id="pic">
265<term><command>pic</command></term>
[c6cb3aa]266<listitem>
[673b0d8]267<indexterm zone="ch-system-groff pic"><primary sortas="b-pic">pic</primary></indexterm>
[c6cb3aa]268<para>compiles descriptions of pictures embedded
[673b0d8]269within troff or TeX input files into commands understood by TeX or troff.</para>
[c6cb3aa]270</listitem>
271</varlistentry>
[673b0d8]272
[b8a819f]273<varlistentry id="pic2graph">
274<term><command>pic2graph</command></term>
[c6cb3aa]275<listitem>
[673b0d8]276<indexterm zone="ch-system-groff pic2graph"><primary sortas="b-pic2graph">pic2graph</primary></indexterm>
[c6cb3aa]277<para>converts a PIC diagram into a cropped image.</para>
278</listitem>
279</varlistentry>
[673b0d8]280
[b8a819f]281<varlistentry id="pre-grohtml">
282<term><command>pre-grohtml </command></term>
[c6cb3aa]283<listitem>
[673b0d8]284<indexterm zone="ch-system-groff pre-grohtml"><primary sortas="b-pre-grohtml">pre-grohtml</primary></indexterm>
[c6cb3aa]285<para>translates the output of GNU troff to html.</para>
286</listitem>
287</varlistentry>
[673b0d8]288
[b8a819f]289<varlistentry id="post-grohtml">
290<term><command>post-grohtml</command></term>
[c6cb3aa]291<listitem>
[673b0d8]292<indexterm zone="ch-system-groff post-grohtml"><primary sortas="b-post-grohtml">post-grohtml</primary></indexterm>
[c6cb3aa]293<para>translates the output of GNU troff to html.</para>
294</listitem>
295</varlistentry>
[673b0d8]296
[b8a819f]297<varlistentry id="refer">
298<term><command>refer</command></term>
[c6cb3aa]299<listitem>
[673b0d8]300<indexterm zone="ch-system-groff refer"><primary sortas="b-refer">refer</primary></indexterm>
[c6cb3aa]301<para>copies the contents of a file to the
[673b0d8]302standard output, except that lines between .[ and .] are interpreted as
303citations, and lines between .R1 and .R2 are interpreted as commands about
304how citations are to be processed.</para>
[c6cb3aa]305</listitem>
306</varlistentry>
[673b0d8]307
[b8a819f]308<varlistentry id="soelim">
309<term><command>soelim</command></term>
[c6cb3aa]310<listitem>
[673b0d8]311<indexterm zone="ch-system-groff soelim"><primary sortas="b-soelim">soelim</primary></indexterm>
[c6cb3aa]312<para>reads files and replaces lines of the form
[673b0d8]313<emphasis>.so file</emphasis> by the contents of the mentioned
314<emphasis>file</emphasis>.</para>
[c6cb3aa]315</listitem>
316</varlistentry>
[673b0d8]317
[b8a819f]318<varlistentry id="tbl">
319<term><command>tbl</command></term>
[c6cb3aa]320<listitem>
[673b0d8]321<indexterm zone="ch-system-groff tbl"><primary sortas="b-tbl">tbl</primary></indexterm>
[c6cb3aa]322<para>compiles descriptions of tables embedded
[673b0d8]323within troff input files into commands that are understood by troff.</para>
[c6cb3aa]324</listitem>
325</varlistentry>
[673b0d8]326
[b8a819f]327<varlistentry id="tfmtodit">
328<term><command>tfmtodit</command></term>
[c6cb3aa]329<listitem>
[673b0d8]330<indexterm zone="ch-system-groff tfmtodit"><primary sortas="b-tfmtodit">tfmtodit</primary></indexterm>
[c6cb3aa]331<para>creates a font file for use with groff -Tdvi.</para>
332</listitem>
333</varlistentry>
[673b0d8]334
[b8a819f]335<varlistentry id="troff">
336<term><command>troff</command></term>
[c6cb3aa]337<listitem>
[673b0d8]338<indexterm zone="ch-system-groff troff"><primary sortas="b-troff">troff</primary></indexterm>
[c6cb3aa]339<para>is highly compatible with Unix troff. Usually it should be invoked using the
340groff command, which will also run preprocessors and post-processors in the
341appropriate order and with the appropriate options.</para>
342</listitem>
343</varlistentry>
344
[b8a819f]345<varlistentry id="zsoelim">
346<term><command>zsoelim</command></term>
[c6cb3aa]347<listitem>
[673b0d8]348<indexterm zone="ch-system-groff zsoelim"><primary sortas="b-zsoelim">zsoelim</primary></indexterm>
[c6cb3aa]349<para>is the GNU implementation of soelim.</para>
350</listitem>
351</varlistentry>
352</variablelist>
[673b0d8]353
354</sect2>
355
356</sect1>
Note: See TracBrowser for help on using the repository browser.