-a Generate a plain text approximation of the typeset output.
The read-only register .A is set to 1. This option
produces a sort of abstract preview of the formatted
output.
• Page breaks are marked by a phrase in angle
brackets; for example, '<beginning of page>'.
• Lines are broken where they would be in the
formatted output.
• A horizontal motion of any size is represented as
one space. Adjacent horizontal motions are not
combined. Inter-sentence space nodes (those
arising from the second argument to the .ss
request) are not represented.
• Vertical motions are not represented.
• Special characters are rendered in angle brackets;
for example, the default soft hyphen character
appears as '<hy>'.
The above description should not be considered a
specification; the details of -a output are subject to
change.
-b Write a backtrace reporting the state of troff's input
parser to the standard error stream with each diagnostic
message. The line numbers given in the backtrace might
not always be correct, because troff's idea of line
numbers can be confused by requests that append to strings
or macros.
-c Start with color output disabled.
-C Enable AT&T troff compatibility mode; implies -c.
-d cs
-d name=string
Define roff string c or name as s or string; c must be a
one-character name. Due to getopt_long(3) limitations,
c cannot be and name cannot contain an equals sign, even
though that is a valid character in a roff identifier.
-E Inhibit troff error messages; implies -Ww. This option
does not suppress messages sent to the standard error
stream by documents or macro packages using .tm or related
requests.
-f fam Use fam as the default font family.
-F dir Search in directory dir for the selected output device's
directory of device and font description files. See the
description of GROFF_FONT_PATH in section 'Environment'
below for the default search locations and ordering.
-i Read the standard input after all the named input files
have been processed.
-I dir Search dir for input files (those on the command line,
those named in .psbb, .so, and .soquiet requests, and
those named in '\X'ps: import'', '\X'ps: file'', and
'\X'pdf: pdfpic'' escape sequences). This option may be
specified more than once; the directories are then
searched in the order specified. If you want to search
the current directory before others, add '-I .' at the
appropriate place. The current working directory is
otherwise searched last. -I works similarly to, and is
named for, the 'include' option of Unix C compilers. No
directory search is performed for files specified using an
absolute file name.
-m name
Process name.tmac before any input files. If name.tmac is
not found, tmac.name is attempted. name (in both
arrangements) is presumed to be a macro file; see the
description of GROFF_TMAC_PATH in section 'Environment'
below for the default search locations and ordering.
-M dir Search directory dir for macro files. See the description
of GROFF_TMAC_PATH in section 'Environment' below for the
default search locations and ordering.
-n num Number the first page num.
-o list
Output only pages in list, which is a comma-separated list
of page ranges; n means print page n, m-n means print
every page between m and n, n, -n means print every page
up to n, and n- means print every page from n on. troff
stops processing and exits after formatting the last page
enumerated in list.
-r cn
-r reg=n
Define roff register c or reg as groff numeric
expression n or expr; c must be a one-character name. Due
to getopt_long(3) limitations, c cannot be and reg cannot
contain an equals sign, even though that is a valid
character in a roff identifier.
-R Don't load troffrc and troffrc-end.
-T dev Prepare output for device dev, rather than the default,
'ps'; see groff(1).
-U Operate in unsafe mode, which enables the .open, .opena,
.pi, .pso, and .sy requests. These requests are disabled
by default because they allow an untrusted input document
to write to arbitrary file names and run arbitrary
commands. This option also adds the current directory to
the macro search path; see the -m option above.
-w name
-W name
Enable (-w) or inhibit (-W) emission of warnings in
category name. See section 'Warnings' below.
-z Suppress formatted output.
