%general-entities; ]> groff &groff-version;
&groff-url;
Groff-&groff-version; Groff <para>The Groff package contains programs for processing and formatting text.</para> <segmentedlist> <segtitle>&buildtime;</segtitle> <segtitle>&diskspace;</segtitle> <seglistitem> <seg>&groff-ch6-sbu;</seg> <seg>&groff-ch6-du;</seg> </seglistitem> </segmentedlist> </sect2> <sect2 role="installation"> <title>Installation of Groff Apply the patch that adds the ascii8 and nippon devices to Groff: patch -Np1 -i ../&groff-debian-patch; 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. Many screen fonts don't have Unicode single quotes and dashes in them. Tell Groff to use the ASCII equivalents instead: sed -i -e 's/2010/002D/' -e 's/2212/002D/' \ -e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto Groff expects the environment variable PAGE to contain the default paper size. For users in the United States, PAGE=letter is appropriate. Elsewhere, PAGE=A4 may be more suitable. While the default paper size is configured during compilation, it can be overridden later by echoing either A4 or letter to the /etc/papersize file. Prepare Groff for compilation: PAGE=<paper_size> ./configure --prefix=/usr --enable-multibyte Compile the package: make This package does not come with a test suite. Install the package: make docdir=/usr/share/doc/groff-&groff-version; install Some documentation programs, such as xman, will not work properly without the following symlinks: ln -sv eqn /usr/bin/geqn ln -sv tbl /usr/bin/gtbl Contents of Groff Installed programs addftinfo, afmtodit, eqn, eqn2graph, geqn (link to eqn), grn, grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl (link to tbl), hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml, pre-grohtml, refer, soelim, tbl, tfmtodit, and troff Short Descriptions addftinfo Reads a troff font file and adds some additional font-metric information that is used by the groff system addftinfo afmtodit Creates a font file for use with groff and grops afmtodit eqn Compiles descriptions of equations embedded within troff input files into commands that are understood by troff eqn eqn2graph Converts a troff EQN (equation) into a cropped image eqn2graph geqn A link to eqn geqn grn A groff preprocessor for gremlin files grn grodvi A driver for groff that produces TeX dvi format grodvi groff A front-end to the groff document formatting system; normally, it runs the troff program and a post-processor appropriate for the selected device groff groffer Displays groff files and man pages on X and tty terminals groffer grog Reads files and guesses which of the groff options , , , , , , , and are required for printing files, and reports the groff command including those options grog grolbp Is a groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers) grolbp grolj4 Is a driver for groff that produces output in PCL5 format suitable for an HP LaserJet 4 printer grolj4 grops Translates the output of GNU troff to PostScript grops grotty Translates the output of GNU troff into a form suitable for typewriter-like devices grotty gtbl A link to tbl gtbl hpftodit Creates a font file for use with groff -Tlj4 from an HP-tagged font metric file hpftodit indxbib Creates an inverted index for the bibliographic databases with a specified file for use with refer, lookbib, and lkbib indxbib lkbib Searches bibliographic databases for references that contain specified keys and reports any references found lkbib lookbib Prints a prompt on the standard error (unless the standard input is not a terminal), reads a line containing a set of keywords from the standard input, searches the bibliographic databases in a specified file for references containing those keywords, prints any references found on the standard output, and repeats this process until the end of input lookbib mmroff A simple preprocessor for groff mmroff neqn Formats equations for American Standard Code for Information Interchange (ASCII) output neqn nroff A script that emulates the nroff command using groff nroff pfbtops Translates a PostScript font in .pfb format to ASCII pfbtops pic Compiles descriptions of pictures embedded within troff or TeX input files into commands understood by TeX or troff pic pic2graph Converts a PIC diagram into a cropped image pic2graph post-grohtml Translates the output of GNU troff to HTML post-grohtml pre-grohtml Translates the output of GNU troff to HTML pre-grohtml refer Copies the contents of a file to the standard output, except that lines between .[ and .] are interpreted as citations, and lines between .R1 and .R2 are interpreted as commands for how citations are to be processed refer soelim Reads files and replaces lines of the form .so file by the contents of the mentioned file soelim tbl Compiles descriptions of tables embedded within troff input files into commands that are understood by troff tbl tfmtodit Creates a font file for use with groff -Tdvi tfmtodit troff Is highly compatible with Unix troff; it should usually be invoked using the groff command, which will also run preprocessors and post-processors in the appropriate order and with the appropriate options troff