Click on any of the 687 commands below to get a description and list of available options. All links in the command summaries point to the online version of the book on Safari Bookshelf.
Frontend to the groff document-formatting system, which normally runs troff along with a postprocessor appropriate for the selected output device. Options without arguments can be grouped after a single dash (-). A filename of - denotes standard input.
Options
-a
Generate an ASCII approximation of the typeset output.
-b
Print a backtrace.
-C
Enable compatibility mode.
-dcs, -dname=s
Define the character c or string name to be the string s.
-e
Preprocess with eqn, the equation formatter.
-E
Don't print any error messages.
-ffam
Use fam as the default font family.
-Fdir
Search dir for subdirectories with DESC and font files before searching the default directory /usr/lib/groff/font.
-h
Print a help message.
-i
Read standard input after all files have been processed.
-l
Send the output to a print spooler (as specified by the print command in the device description file).
-Larg
Pass arg to the spooler. Each argument should be passed with a separate -L option.
-mname
Read the macro file tmac.name.
-Mdir
Search directory dir for macro files before searching the default directory /usr/lib/groff/tmac.
-nnum
Set the first page number to num.
-N
Don't allow newlines with eqn delimiters; equivalent to eqn's -N option.
-olist
Output only pages specified in list, a comma-separated list of page ranges.
-p
Preprocess with pic.
-Parg
Pass arg to the postprocessor. Each argument should be passed with a separate -P option.
-rcn, -name=n
Set the number register c or name to n. c is a single character, and n is any troff numeric expression.
-R
Preprocess with refer.
-s
Preprocess with soelim.
-S
Use safer mode (that is, pass the -S option to pic and use the -msafer macros with troff).
-t
Preprocess with tbl.
-Tdev
Prepare output for device dev; the default is ps.
-v
Make programs run by groff print out their version number.
-V
Print the pipeline on stdout instead of executing it.
-wname
Enable warning name. You can specify multiple -w options. See the troff manpage for a list of warnings.
-Wname
Disable warning name. You can specify multiple -W options. See the troff manpage for a list of warnings.
-z
Suppress troff output (except error messages).
-Z
Do not postprocess troff output. Normally groff automatically runs the appropriate postprocessor.
Devices
ascii
Typewriter-like device.
dvi
TEX dvi format.
latin1
Typewriter-like devices using the ISO Latin-1 character set.
ps
PostScript.
X75
75-dpi X11 previewer.
X100
100-dpi X11 previewer.
lj4
HP LaserJet4-compatible (or other PCL5-compatible) printer.
Environment variables
GROFF_COMMAND_PREFIX
If set to be X, groff will run Xtroff instead of troff.
GROFF_FONT_PATH
Colon-separated list of directories in which to search for the devname directory.
GROFF_TMAC_PATH
Colon-separated list of directories in which to search for the macro files.
GROFF_TMPDIR
If set, temporary files will be created in this directory; otherwise, they will be created in TMPDIR (if set) or /tmp (if TMPDIR is not set).