The following options either do not exist for
troff or are differently interpreted by
groff. Preprocess with
eqn. Preprocess with
grn. Preprocess with
grap. Print a help message. This option may be used to specify a directory to search for files (both those on the command line and those named in
.psbb and
.so requests, and
\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 will be searched in the order specified. No directory search is performed for files specified using an absolute path. This option implies the option. Send the output to a spooler program for printing. The command that should be used for this is specified by the
print command in the device description file, see
groff_font(5). If this command is not present, the output is piped into the
lpr(1) program by default. See options and Pass
arg to the spooler program. Several arguments should be passed with a separate option each. Note that
groff does not prepend (a minus sign) to
arg before passing it to the spooler program. Don't allow newlines within
eqn delimiters. This is the same as the option in
eqn. Preprocess with
pic. Pass
-option or
-option arg to the postprocessor. The option must be specified with the necessary preceding minus sign(s) or because groff does not prepend any dashes before passing it to the postprocessor. For example, to pass a title to the gxditview postprocessor, the shell command
Preprocess with refer. No mechanism is provided for passing arguments to refer because most refer options have equivalent language elements that can be specified within the document. See refer(1) for more details. Preprocess with soelim. Safer mode. Pass the option to pic and disable the following troff requests: .open, .opena, .pso, .sy, and .pi. For security reasons, safer mode is enabled by default. Preprocess with tbl. Set output device to dev. For this device, troff generates the intermediate output; see groff_out(5). Then groff calls a postprocessor to convert troff's intermediate output to its final format. Real devices in groff are
dvi
TeX DVI format (postprocessor is grodvi).
html
HTML output (preprocessors are soelim and pre-grohtml, postprocessor is post-grohtml).
lbp
Canon CAPSL printers (LBP-4 and LBP-8 series laser printers; postprocessor is grolbp).
lj4
HP LaserJet4 compatible (or other PCL5 compatible) printers (postprocessor is grolj4).
ps
PostScript output (postprocessor is grops).
For the following TTY output devices (postprocessor is always grotty), selects the output encoding:
cp1047
Latin-1 character set for EBCDIC hosts.
utf8
Unicode character set in UTF-8 encoding.
The following arguments select gxditview as the `postprocessor' (it is rather a viewing program):
X75
75dpi resolution, 10pt document base font.
X75-12
75dpi resolution, 12pt document base font.
X100
100dpi resolution, 10pt document base font.
X100-12
100dpi resolution, 12pt document base font.
The default device is ps. Unsafe mode. Reverts to the (old) unsafe behaviour; see option Output version information of groff and of all programs that are run by it; that is, the given command line is parsed in the usual way, passing to all subprograms. Output the pipeline that would be run by groff (as a wrapper program) on the standard output, but do not execute it. If given more than once, the commands will be both printed on the standard error and run. Use gxditview instead of using the usual postprocessor to (pre)view a document. The printing spooler behavior as outlined with options and is carried over to gxditview(1) by determining an argument for the -printCommand option of gxditview(1). This sets the default Print action and the corresponding menu entry to that value. only produces good results with and The default resolution for previewing output is 75dpi; this can be changed by passing the option to gxditview, for example
Suppress output generated by troff. Only error messages will be printed. Print the groff intermediate output to standard output; see groff_out(5). Normally groff calls automatically a postprocessor. With this option, the output of troff for the device, the so-called intermediate output is issued without postprocessing.