Add search directory for soelim(1). 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.
Dont 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
is equivalent to
gxditview @-]title groff it @-]
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. Contrary to troff, groff calls a postprocessor to convert troffs intermediate output to its final format. Real devices in groff are
TeX DVI format (postprocessor is grodvi).
HTML output (preprocessors are soelim and pre-grohtml, postprocessor is post-grohtml).
Canon CAPSL printers ( LBP-4 and LBP-8 series laser printers; postprocessor is grolbp).
HP LaserJet4 compatible (or other PCL5 compatible) printers (postprocessor is grolj4).
PostScript output (postprocessor is grops).
For the following TTY output devices (postprocessor is always grotty), selects the output encoding:
Latin-1 character set for EBCDIC hosts.
Unicode character set in UTF-8 encoding.
The following arguments select gxditview as the postprocessor (it is rather a viewing program):
75dpi resolution, 10pt document base font.
75dpi resolution, 12pt document base font.
100dpi resolution, 10pt document base font.
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), but do not execute it.
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.
Do not postprocess the output of troff that is normally called automatically by groff. This will print the intermediate output to standard output; see groff_out(5).
The traditional man page format; see groff_man(7). It can be specified on the command line as or man.
The general package for man pages; it automatically recognizes whether the documents uses the man or the mdoc format and branches to the corresponding macro package. It can be specified on the command line as or mandoc.
The BSD-style man page format; see groff_mdoc(7). It can be specified on the command line as or mdoc.
The classical me document format; see groff_me(7). It can be specified on the command line as or me.
The classical mm document format; see groff_mm(7). It can be specified on the command line as or mm.
The classical ms document format; see groff_ms(7). It can be specified on the command line as or ms.
HTML-like macros for inclusion in arbitrary groff documents; see groff_www(7).
Details on the naming of macro files and their placement can be found in groff_tmac(5).
for printers compatible to the HP LaserJet~4 and PCL5,
for text output using various encodings, e.g. on text-oriented terminals or line-printers.
Today, most printing or drawing hardware is handled by the operating system, by device drivers, or by software interfaces, usually accepting PostScript. Consequently, there isnt an urgent need for more hardware device postprocessors.
The groff software devices for conversion into other document file formats are
for the DVI format,
for HTML format,
Combined with the many existing free conversion tools this should be sufficient to convert a troff document into virtually any existing data format.
This search path, followed by $PATH, will be used for commands that are executed by groff. If it is not set then the directory where the groff binaries were installed is prepended to PATH.
When there is a need to run different roff implementations at the same time groff provides the facility to prepend a prefix to most of its programs that could provoke name clashings at run time (default is to have none). Historically, this prefix was the character g, but it can be anything. For example, gtroff stood for groffs troff, gtbl for the groff version of tbl. By setting GROFF_COMMAND_PREFIX to different values, the different roff installations can be addressed. More exactly, if it is set to prefix xxx then groff as a wrapper program will internally call xxxtroff instead of troff. This also applies to the preprocessors eqn, grn, pic, refer, tbl, soelim, and to the utilities indxbib and lookbib. This feature does not apply to any programs different from the ones above (most notably groff itself) since they are unique to the groff package.
A list of directories in which to search for the devname directory in addition to the default ones. See troff(1) and groff_font(5) for more details.
A list of directories in which to search for macro files in addition to the default directories. See troff(1) and groff_tmac(5) for more details.
The directory in which temporary files will be created. If this is not set but the environment variable TMPDIR instead, temporary files will be created in the directory $TMPDIR. Otherwise temporary files will be created in /tmp. The refer(1), groffer(1), grohtml(1), and grops(1) commands use temporary files.
Preset the default device. If this is not set the ps device is used as default. This device name is overwritten by the option