nroff(1M) nroff(1M)
NAME
nroff - text formatting language
SYNOPSIS
nroff [option ...] file ... | printer
DESCRIPTION
nroff formats text contained in file(s) (standard input by default)
for printing on typewriter-like devices and line printers.
An argument consisting of a minus (-) is taken to be a file name cor-
responding to the standard input.
OPTIONS
The option(s), which may appear in any order, but must appear before
the file(s), are:
-olist Print only pages whose page numbers appear in the list of
numbers and ranges, separated by commas. A range N - M
means pages N through M; an initial -N means from the
beginning to page N; and a final N- means from N to the
end. (See NOTES below.)
-nN Number first generated page N.
-sN Stop every N pages. nroff will halt after every N pages
(default N = 1) to allow paper loading or changing, and
will resume upon receipt of a line-feed or new-line [new-
lines do not work in pipelines, e.g. with mm(1M)]. This
option does not work if the output of nroff is piped
through col(1). When nroff halts between pages, an ASCII
BEL is sent to the terminal.
-raN Set register a (which must have a one-character name) to
N.
-i Read standard input after files are exhausted.
-q Invoke the simultaneous input-output mode of the .rd
request.
-Q Messages generated by .tm (terminal message) requests will
be suppressed.
-z Print only messages generated by .tm (terminal message)
requests.
-mname Prepend to the input file(s) the macro file
/usr/lib/tmac/tmac.name.
Page 1 Reliant UNIX 5.44 Printed 11/98
nroff(1M) nroff(1M)
-Tttytype Prepare output for specified terminal. Known ttytype(s)
are:
2631 Hewlett-Packard 2631 printer in regular mode
2631-c Hewlett-Packard 2631 printer in compressed mode
2631-e Hewlett-Packard 2631 printer in expanded mode
300 DASI-300 printer
300-12 DASI-300 terminal set to 12-pitch (12 characters
per inch)
300s DASI-300s printer (300S is a synonym)
300s-12 DASI-300s printer set to 12-pitch (12 characters
per inch) (300S-12 is a synonym)
37 TELETYPE Model 37 terminal (default)
382 DTC-382
4000a Trendata 4000a terminal (4000A is a synonym)
450 DASI-450 (Diablo Hyterm) printer
450-12 DASI-450 terminal set to 12-pitch (12 characters
per inch)
832 Anderson Jacobson 832 terminal
8510 C.ITOH printer
lp generic name for printers that can underline and
tab (All text using reverse line feeds, such as
those having tables, that is sent to lp must be
processed with col.)
tn300 GE Terminet 300 terminal
X printers equipped with TX print train
X97 Xerox 9700 page printer (use with x9700 filter)
X97ni Xerox 9700 page printer with underscores (no
italics) (use with x9700 filter)
-e Produce equally-spaced words in adjusted lines, using the
full resolution of the particular terminal.
-h Use output tabs during horizontal spacing to speed output
and reduce output character count. Tab settings are
assumed to be every 8 nominal character widths.
-un Set the emboldening factor (number of character over-
strikes) for the third font position (bold) to n, or to
zero if n is missing.
Page 2 Reliant UNIX 5.44 Printed 11/98
nroff(1M) nroff(1M)
NOTES
When nroff is used with the -olist option inside a pipeline [e.g. with
one or more of eqn(1M), and tbl(1M)], it may cause a harmless "broken
pipe" diagnostic if the last page of the document is not specified in
list.
FILES
/usr/lib/tmac/tmac.* pointers to standard macro files
/usr/lib/macros/* standard macro files
/usr/lib/nterm/* terminal driving tables for nroff
/usr/pub/terminals list of supported terminals
SEE ALSO
col(1), mm(1M), neqn(1M), troff(1M), nterm(5).
REFERENCE
J. F. Ossanna, Nroff/Troff User's Manual
D. Dougherty, T. O'Reilly, UNIX TEXT PROCESSING, Hayden Books, Indi-
anapolis, Indiana 46268 USA, ISBN 0-672-46291-5
Page 3 Reliant UNIX 5.44 Printed 11/98