(BSD System Compatibility)

nroff(1bsd)


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.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004