nroff(1) manual page
Table of Contents
nroff - format documents for display or line-printer
nroff [
-ehiq ] [ -mname ] [ -nN ] [ -opagelist ] [ -raN ] [ -sN ] [ -Tname ]
SUNWdoc
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 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:
- Teletype
Corporation Model 37 terminal -- this is the default.
- lp | tn300
- GE
Any line
printer or terminal without half-line capability.
- DASI
-300.
- 300-12
- DASI
-300 --
12-pitch.
- 300S
- DASI
-300S.
- 300S-12
- DASI
-300S.
- DASI
-382 (fancy DTC
382).
- DASI
-450 (Diablo
Hyterm).
- 450-12
- DASI
-450 (Diablo Hyterm) -- 12-pitch.
- AJ
832.
The following
command:
- example% nroff -s4 -me users.guide
formats users.guide using the -me
macro package, and stopping every 4 pages.
- /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
checknr(1)
, col(1)
, eqn(1)
, man(1)
,
tbl(1)
, troff(1)
, term(5)
, me(5)
, ms(5)
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.
Table of Contents