nroff(1)
NAME
nroff − format documents for display or line-printer
SYNOPSIS
nroff [ −ehiq ] [ −mname ] [ −nN ] [ −opagelist ] [ −raN ] [ −sN ] [ −Tname ]
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(9F) 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.
EXAMPLES
The following command:
example% nroff −s4 −me users.guide
formats users.guide using the −me macro package, and stopping every 4 pages.
ENVIRONMENT
See environ(5) for descriptions of the following environment variables that affect the execution of nroff: LC_CTYPE, LC_MESSAGES, and NLSPATH.
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
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWdoc |
| CSI | Enabled |
SEE ALSO
checknr(1), col(1), eqn(1), man(1), tbl(1), troff(1), attributes(5), environ(5), me(5), ms(5), term(5), rd(9F)
SunOS 5.6 — Last change: 20 Dec 1996