NAME

nroff − text formatting and typesetting

SYNOPSIS

nroff [ −opagelist ] [ −nN ] [ −sN ] [ −mname ] [ −raN ] [ −i ] [ −q ] [ −Tname ]

[ −e ] [ −h ] [ file ] ...

DESCRIPTION

Nroff formats text in the named files for typewriter-like devices.  See also troff(1). The full capabilities of nroff and troff are described in the Nroff/Troff User’s Manual. 

If no file argument is present, nroff reads the standard input.  An argument consisting of a single minus (−) is taken to be a file name corresponding to the standard input. 

OPTIONS

Options may appear in any order so long as they appear before the files. 

−olist Print only pages whose page numbers appear in the comma-separated list of numbers and ranges.  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. 

−nN Number first generated page N.

−sN Stop every N pages.  Nroff will halt prior to every N pages (default N=1) to allow paper loading or changing, and will resume upon receipt of a newline.

−mname
Prepend the macro file /usr/lib/tmac/tmac.name to the input files.

−raN Set register a (one-character) to N.

−i Read standard input after the input files are exhausted. 

−q Invoke the simultaneous input-output mode of the rd request. 

−Tname
Prepare output for a device of the specified name.  Known names are:

37Teletype Corporation Model 37 terminal — this is the default. 

tn300GE TermiNet 300 (or any terminal without half-line capability),

300SDASI-300S

300DASI-300

300XDASI-300X

450DASI-450 (Diablo Hyterm). 

450-12DASI-450 (Diablo Hyterm) — 12-pitch. 

450-12-8DASI-450 (Diablo Hyterm) — 12-pitch and 8 lines-per-inch. 

450XDASI-450X (Diablo Hyterm). 

lprLine printer. 

x1700Xerox 1700 daisywheel printer. 

−e Produce equally-spaced words in adjusted lines, using full terminal resolution. 

−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. 

EXAMPLE

gaia% nroff −s4 −me users.guide

Formats users.guide using the −me macro package, and stopping every 4 pages. 

FILES

/tmp/ta∗temporary file
/usr/lib/tmac/tmac.∗standard macro files
/usr/lib/term/∗terminal driving tables for nroff

SEE ALSO

Nroff/Troff user’s manual and A TROFF Tutorial in the Sun document entitled Editing and Text Processing. 
troff(1), eqn(1), tbl(1), ms(7), me(7), man(7), col(1)

Sun System Release 1.0  —  2 November 1983