by Trent A. Fisher and Werner Lemberg - The GNU Operating System

Chapter 2: Invoking groff 9
page 13). This option is passed to all pre- and postprocessors
using the GROFF_FONT_PATH environment variable.
‘-g’ Preprocess with ggrn.
‘-G’ Preprocess with grap.
‘-h’ Print a help message.
‘-i’ Read the standard input after all the named input files have
been processed.
‘-Idir’ This option may be used to specify a directory to search for files.
It is passed to the following programs:
• gsoelim (see Section 6.7 [gsoelim], page 187 for more details);
it also implies groff’s ‘-s’ option.
• gtroff; it is used to search files named in the psbb and so
requests.
• grops; it is used to search files named in the \X’ps: import
and \X’ps: file escapes.
The current directory is always searched first. This option may
be specified more than once; the directories are searched in the
order specified. No directory search is performed for files specified
using an absolute path.
‘-k’ Preprocess with preconv. This is run before any other preprocessor.
Please refer to preconv’s manual page for its behaviour
if no ‘-K’ (or ‘-D’) option is specified.
‘-Karg’ Set input encoding used by preconv to arg. Implies ‘-k’.
‘-l’ Send the output to a spooler for printing. The command used for
this is specified by the print command in the device description
file (see Section 8.2 [Font Files], page 204, for more info). If not
present, ‘-l’ is ignored.
‘-Larg’ Pass arg to the spooler. Each argument should be passed with a
separate ‘-L’ option. Note that groff does not prepend a ‘-’ to
arg before passing it to the postprocessor. If the print keyword
in the device description file is missing, ‘-L’ is ignored.
‘-mname’ Read in the file ‘name.tmac’. Normally groff searches for this
in its macro directories. If it isn’t found, it tries ‘tmac.name’
(searching in the same directories).
‘-Mdir’ Search directory ‘dir’ for macro files before the standard directories
(see Section 2.3 [Macro Directories], page 13).
‘-nnum’ Number the first page num.
‘-N’ Don’t allow newlines with eqn delimiters. This is the same as
the ‘-N’ option in geqn.