NAME

nroff − format or typeset text

SYNOPSIS

nroff [ options ] [ files ] [ | printer ]

DESCRIPTION

Nroff formats text contained in files (standard input by default) for printing on typewriter-like devices and line printers. 

An argument consisting of a minus (−) is taken to be a file name corresponding to the standard input.  The options, which may appear in any order, but must appear before the files, are:

−olist Print only pages whose page numbers appear in the list of numbers and ranges, separated by commas.  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.  (See BUGS below.) 

−nN Number first generated page N.

−sN Stop every N pages.  Nroff will halt after every N pages (default N=1) to allow paper loading or changing, and will resume upon receipt of a line-feed or new-line (new-lines do not work in pipelines, e.g., with mm(1)). This option does not work if the output of nroff is piped through col(1). When nroff halts between pages, an ASCII BEL is sent to the terminal. 

−raN Set register a (which must have a one-character name) to N.

−i Read standard input after files are exhausted. 

−q Invoke the simultaneous input-output mode of the .rd request. 

−z Print only messages generated by .tm (terminal message) requests. 

−m name Prepend to the input files the macro file /usr/lib/tmac/tmac.name. 

−Ttty_type
Prepare output for specified terminal. Known tty_type types are

2631
Hewlett-Packard 2631 printer in regular mode

2631−c
Hewlett-Packard 2631 printer in compressed mode

2631−e
Hewlett Packard 2631 printer in expanded mode

300
DASI-300 printer

300-12
DASI-300 terminal set to 12-pitch (12 characters per inch)

300s
DASI-300s printer (300S is a synonym)

300s-12
DASI-300s printer set to 12-pitch (12 characters per inch) (300S is a synonym)

37
Teletype Model 37 terminal

382
DTC-382

4000a
Trendata 4000a terminal (4000A is a synonym)

450
DASI-450 (Diablo Hyterm) printer

450-12
DASI-450 terminal set to 12-pitch (12 characters per inch)

832
Anderson Jacobson 832 terminal

8510
C.ITOH printer

lp
generic name for printers that can underline and tab.  (all text using reverse line feeds, such as those having tables, that is sent to lp must be processed with col). 

tn300
GE Terminet 300 terminal

X
printers equipped with TX print train

−e Produce equally-spaced words in adjusted lines, using the full resolution of the particular terminal. 

−h Use output tabs during horizontal spacing to speed output and reduce output character count.  Tab settings are assumed to be every 8 nominal character widths. 

−un Set the emboldening factor (number of character overstrikes) for the third font position (bold) to n, or to zero if n is missing. 

FILES

/usr/lib/tmac/tmac.∗pointers to standard macro files

/usr/lib/macros/∗standard macro files

/usr/lib/nterm/∗terminal driving tables for nroff

/usr/pub/terminalslist of supported terminals

SEE ALSO

eqn(1), tbl(1), mm(5), col(1), greek(1), mm(1). 

The section entitled “nroff” in the Documenter’s Workbench User’s Guide. 

The section entitled “nroff/troff” in the Documenter’s Workbench Reference Manual. 

BUGS

Nroff believes in Eastern Standard Time; as a result, depending on the time of the year and on your local time zone, the date that nroff generates may be off by one day from your idea of what the date is. 

When nroff is used with the −olist option inside a pipeline (e.g., with one or more of eqn(1) and tbl(1)), it may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in list.

Version 3.6  —  December 20, 1987