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