NAME

nroff − format documents for display or line-printer

SYNOPSIS

/usr/ucb/nroff [ −ehiqz ] [ −Fdir ] [ −mname ] [ −nN ] [ −opagelist ] [ −raN ]

[ −sN ] [ −Tname ] [ −uN ] [ filename . . . ]

DESCRIPTION

nroff formats text in the named filename for typewriter-like devices.  See also troff. 

If no filename argument is present, nroff reads the standard input.  An argument consisting of a ‘−’ is taken to be a file name corresponding to the standard input. 

The following options may appear in any order, but must appear before the files. 

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

−h Use output TAB characters during horizontal spacing to speed output and reduce output character count.  TAB settings are assumed to be every 8 nominal character widths. 

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

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

−Fdir Search directory dir for font tables instead of the system-dependent default. 

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

−nN Number first generated page N . 

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

−raN Set register a (one-character) to 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. 

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

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

crt | lpr | tn300
GE TermiNet 300, or any line printer or terminal without half-line capability. 

300 DASI-300. 

300-12 DASI-300 — 12-pitch. 

300S | 302 | dtc
DASI-300S. 

300S-12 | 302-12 | dtc12
DASI-300S. 

382 DASI-382 (fancy DTC 382). 

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

450 | ipsi
DASI-450 (Diablo Hyterm). 

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

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

450X DASI-450X (Diablo Hyterm). 

832 AJ 832. 

833 AJ 833. 

832-12 AJ 832 — 12-pitch. 

833-12 AJ 833 — 12-pitch. 

epson Epson FX80. 

itoh C:ITOH Prowriter. 

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

nec NEC 55?0s0 or NEC 77?0s0 Spinwriter. 

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

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

qume Qume Sprint — 5 or9. 

qume12 Qume Sprint — 5 or 9,12-pitch. 

xerox Xerox 17?0 or Diablo 16?0. 

xerox12 Xerox 17?0 or Diablo 16?0 — 12-pitch. 

x-ecs Xerox/Diablo 1730/630 — Extended Character Set. 

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

−uN Set emboldening factor for the font mounted on position 3 to N.  Emboldening is accomplished by overstriking the specified number of times. 

−z Suppress formatted output.  The only output will consist of diagnostic messages from nroff and messages output with the .tm request. 

EXAMPLE

The following command:

nroff −s4 −me users.guide

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

FILES

/tmp/ta∗ temporary file

/usr/ucblib/doctools/tmac/tmac.∗
standard macro files

/usr/ucblib/doctools/term/∗ terminal driving tables for nroff

/usr/ucblib/doctools/term/README
index to terminal description files

SEE ALSO

checknr(1), col(1), eqn(1), tbl(1), troff(1), term(4), man(7), me(7), ms(7). 

  —  BSD Compatibility Package