NAME

nroff − text formatting

SYNOPSIS

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

[ −e ] [ −h ] [ filename ] ...

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 Formatting Documents with Nroff and Troff. 

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

300DASI-300. 

300-12DASI-300 — 12-pitch. 

300SDASI-300S (or 302). 

300S-12DASI-300S (or 302-12). 

300XDASI-300X. 

382DASI-382 (fancy DTC 382). 

382-12DASI-82  (fancy DTC 382 — 12-pitch). 

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

833AJ 833 or AJ 832. 

833-12AJ 833 or AJ 832 — 12-pitch. 

itohC:ITOH Prowriter. 

itoh-12C:ITOH Prowriter — 12-pitch. 

necNEC 55?0 or NEC 77?0 Spinwriter. 

nec12NEC 55?0 or NEC 77?0 Spinwriter — 12-pitch. 

nec-tNEC 55?0/77?0 Spinwriter — Tech-Math/Times-Roman thimble. 

qumeQume Sprint — 5 or 9. 

qume12Qume Sprint — 5 or 9, 12-pitch. 

xeroxXerox 17?0 or Diablo 16?0. 

xerox12Xerox 17?0 or Diablo 16?0 — 12-pitch. 

x-ecsXerox/Diablo 1730/630 — Extended Character Set. 

x-ecs12Xerox/Diablo 1730/630 — Extended Character Set, 12-pitch. 

lprLine 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
/usr/lib/term/README index to terminal description files

SEE ALSO

Formatting Documents on the Sun Workstation
Using nroff and troff on the Sun Workstation
troff(1), eqn(1), tbl(1), ms(7), me(7), man(7), col(1), checknr(1)

Sun Release 3.0β  —  Last change: 23 September 1985