NAME

nroff − format documents for display or line-printer

SYNOPSIS

nroff [ −ehiq ] [ −mname ] [ −nN ] [ −opagelist ] [ −raN ] [ −sN ] [ −Tname ]

AVAILABILITY

SUNWdoc

DESCRIPTION

nroff formats text in the named files for typewriter-like devices.  See also troff(1). 

If no file 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. 

OPTIONS

Options may appear in any order so long as they 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. 

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

lp  |  tn300 GE Any line printer or terminal without half-line capability. 

300 DASI-300. 

300-12 DASI-300 — 12-pitch. 

300S DASI-300S. 

300S-12 DASI-300S. 

382 DASI-382 (fancy DTC 382). 

450
DASI-450 (Diablo Hyterm). 

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

832 AJ 832. 

EXAMPLE

The following command:

example% nroff −s4 −me users.guide

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

FILES

/var/tmp/trtmp∗ temporary file

/usr/share/lib/tmac/tmac.∗ standard macro files

/usr/share/lib/nterm/∗ terminal driving tables for nroff

/usr/share/lib/nterm/README
index to terminal description files

SEE ALSO

checknr(1), col(1), eqn(1), man(1), tbl(1), troff(1), term(5), me(5), ms(5)

NOTES

nroff is not 8-bit clean because making nroff 8-bit clean would require rewriting the nroff internals and filters.  Also, some nroff syntax is based on ASCII only and does not lend itself to 8-bit character sequences. 

SunOS 5.4  —  Last change: 25 Feb 1994