GROFF(1) GROFF(1)
NAME
groff - front end for the groff document formatting system
SYNOPSIS
groff [ -tpeszaivhblCENRVZ ] [ -wname ] [ -Wname ] [
-Hfile ] [ -mname ] [ -Fdir ] [ -Tdev ] [ -ffam ] [ -Mdir
] [ -dcs ] [ -rcn ] [ -nnum ] [ -olist ] [ -Parg ] [
files... ]
DESCRIPTION
groff is a front-end to the groff document formatting sys-
tems. Normally it runs the troff program and a postpro-
cessor appropriate for the selected device. Available
devices are:
ps For PostScript printers and previewers
dvi For TeX dvi format
X75 For a 75 dpi X11 previewer
X100 For a 100dpi X11 previewer
Xps For X11 previewer used with intermediate output for
ps device.
ascii For typewriter-like devices
latin1 For typewriter-like devices using the ISO Latin-1
character set.
The default device is ps. It can optionally preprocess
with any of pic, eqn, tbl, refer, or soelim. It will also
load any macros and eqn definitions required for a partic-
ular device. It can also spool the resulting output.
Options without an argument can be grouped behind a single
-. A filename of - denotes the standard input.
OPTIONS
-h Print a help message.
-e Preprocess with eqn.
-t Preprocess with tbl.
-p Preprocess with pic.
-s Preprocess with soelim.
-R Preprocess with refer. No mechanism is provided
for passing arguments to refer because most refer
options have equivalent commands which can be
included in the file. See refer(1) for more
Groff Version 1.05 November 22, 1992 1
GROFF(1) GROFF(1)
details.
-v Make programs run by groff print out their version
number.
-V Print the pipeline on stdout instead of executing
it.
-z Suppress output from troff. Only error messages
will be printed.
-Z Do not postprocess the output of troff. Normally
groff will automatically run the appropriate post-
processor.
-Parg Pass arg to the postprocessor. Each argument
should be passed with a separate -P option. Note
that groff does not prepend - to arg before passing
it to the postprocessor.
-l Spool the output.
-Larg Pass arg to the spooler. Each argument should be
passed with a separate -L option. Note that groff
does not prepend - to arg before passing it to the
postprocessor.
-Tdev Prepare output for device dev. The default device
is ps.
-N Don't allow newlines with eqn delimiters. This is
the same as the -N option in eqn.
-a
-b
-i
-C
-E
-wname
-Wname
-mname
-olist
-dcs
-rcn
-Fdir
-Mdir
-Hfile
-ffam
-nnum These are as described in troff(1).
ENVIRONMENT
GROFF_TMAC_PATH
A colon separated list of directories in which to
search for macro files.
Groff Version 1.05 November 22, 1992 2
GROFF(1) GROFF(1)
GROFF_TYPESETTER
Default device.
GROFF_FONT_PATH
A colon separated list of directories in which to
search for the devname directory.
GROFF_HYPHEN
File containing hyphenation patterns.
PATH The search path for commands executed by groff.
GROFF_TMPDIR
The directory in which temporary files will be cre-
ated. If this is not set and TMPDIR is set, tempo-
rary files will be created in that directory. Oth-
erwise temporary files will be created in /tmp.
The grops(1) and refer(1) commands can create tem-
porary files.
FILES
/usr/share/misc/hyphen Hyphenation pat-
terns
/usr/share/tmac/tmac.name Macro file used by
-mname.
/usr/share/groff_font/devname/DESC Device description
file for device
name.
/usr/share/groff_font/devname/F Font file for font
F of device name.
/usr/share/groff_font/devname/eqnchar eqn definitions
for device name.
SEE ALSO
grog(1), troff(1), tbl(1), pic(1), eqn(1), soelim(1),
refer(1), grops(1), grodvi(1), grotty(1), groff_font(1),
groff_out(1), groff_ms(1), groff_me(1)
Groff Character Names
Groff Version 1.05 November 22, 1992 3