nroff(1bsd) (BSD System Compatibility)
nroff --
(BSD) format documents for display or line-printer
Synopsis
/usr/ucb/nroff [-ehiqz] [-Fdir] [-mname] [-nN] [-olist] [-raN]
[-sN] [-Tname] [-uN] [file . . .]
Description
nroff
formats text in the named
file
for typewriter-like devices.
[See also
troff(1bsd)].
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.
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/ucblib/doctools/tmac/name
to the input files.
- -nN
-
Number first generated page
N.
- -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.
- -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 TermiNet 300, or any line printer or terminal without half-line
capability.
- 300
-
DASI-300.
- 300-12
-
DASI-300
-- 12-pitch.
- 300S | 300s
-
DASI-300S.
- 300S-12 | 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.
- -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.
Files
- /var/tmp/tr*
-
temporary file
- /usr/ucblib/doctools/tmac/*
-
standard macro files
- /usr/ucblib/doctools/nterm/tab.*
-
terminal driving tables for
nroff
References
checknr(1bsd),
col(1),
eqn(1bsd),
man(5bsd),
me(5bsd),
ms(5bsd),
tbl(1bsd),
term(4),
troff(1bsd)
Examples
The following command:
nroff -s4 -me users.guide
formats
users.guide
using the
-me
macro package, and stopping every 4 pages.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.