Name

mmroff - reference- and PostScript inclusion-handling front end for GNU roff mm macro package

Synopsis

Description

mmroff is a simple wrapper for groff, used to expand internal references in mm documents; see groff_mm(7). It runs groff with the -mm option twice, first with -z and -rRef=1 to populate reference and index files with their corresponding entries, and then without to produce the document. It also handles the inclusion of PostScript images with the PIC macro. Documents that do not use these features of groff mm (the INITI, IND, INDP, INITR, SETR, GETHN, GETPN, GETR, GETST, and PIC macros) do not require mmroff.

Options

--help displays a usage message, while --version shows version information; both exit afterward.

-x

Create or update the reference list file and exit.

Environment

Normally, the path separator in environment variables ending with PATH is the colon; this may vary depending on the operating system. For example, Windows uses a semicolon instead.

GROFF_BIN_PATH

Locate groff commands in these directories, followed by those in PATH. If not set, the installation directory of GNU roff executables, /usr/bin, is searched before PATH.

Exit status

mmroff exits with status 0 if the --help or --version options were specified, or if -x was specified and the program successfully created or updated the reference list file. It exits with status 1 if it was unable to create necessary files. Otherwise, it exits with the status of groff.

Authors

mmroff was written by Jrgen Hgg of Lund, Sweden.

See also

groff_mm(7), groff_mmse(7), groff(1), troff(1), tbl(1), pic(1), eqn(1)