xref: /original-bsd/old/roff/nroff/nroff.1 (revision ff9931ee)
1.\" Copyright (c) 1983, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.proprietary.roff%
5.\"
6.\"	@(#)nroff.1	6.8 (Berkeley) 08/09/91
7.\"
8.Dd
9.Dt NROFF 1
10.Os BSD 4.2
11.Sh NAME
12.Nm nroff
13.Nd text formatting
14.Sh SYNOPSIS
15.Nm nroff
16.Op option
17.Ar ...
18.Op file
19.Ar ...
20.Sh DESCRIPTION
21.Nm Nroff
22formats text in the named
23.Ar files
24for typewriter-like devices.  See also
25.Xr troff 1  .
26The full capabilities of
27.Nm nroff
28are described in the
29.%T "Nroff/Troff User's Manual" .
30.Pp
31If no
32.Ar file
33argument is present, the standard input is read.
34An argument consisting of a single minus
35.Fl
36is taken to be a file name corresponding to the standard input.
37.Pp
38The options, which may appear in any order so long as they appear
39.Ar before
40the files, are:
41.Bl -tag -width indent
42.It Fl o Ns Ar list
43Print only pages whose page numbers appear in the comma-separated
44.Ar list
45of numbers and ranges.  A range
46.Ar N\-M
47means pages
48.Ar N
49through
50.Ar M  ;
51an initial
52.Ar \-N
53means from the beginning to page
54.Ar N  ;
55and a final
56.Ar N\-
57means from
58.Ar N
59to the end.
60.It Fl n Ns Ar N
61Number first generated page
62.Ar N  .
63.It Fl s Ns Ar N
64Stop every
65.Ar N
66pages.
67.Nm Nroff
68will halt prior to every
69.Ar N
70pages (default
71.Ar N Ns =1)
72to allow paper loading or changing, and will resume upon receipt of a newline.
73.It Fl m Ns Ar name
74Prepend the macro file
75.Pa /usr/share/tmac/tmac.name
76to the input
77.Ar files  .
78.It Fl r Ns Ar aN
79Set register
80.Ar a
81(one-character) to
82.Ar N  .
83.It Fl i
84Read standard input after the input files are exhausted.
85.It Fl q
86Invoke the simultaneous input-output mode of the
87.Ar rd
88request.
89.It Fl T Ns Ar name
90Prepare output for specified terminal.  Known
91.Ar names
92are:
93.Pp
94.Bl -tag -width xeroxxx -compact
95.It Cm 37
96for the Teletype Corporation Model 37 terminal,
97.It Cm crt
98the default; linked to lpr and tn300, for the GE TermiNet 300 (or any
99terminal without reverse-line or half-line capability),
100.It Cm 300
101for the DTC 300,
102.It Cm 302
103for the DTC 302S and the DTC 300S,
104.It Cm 382
105for the DTC 382,
106.It Cm 450
107for the DTC 450 and the IPSI 1622,
108.It Cm 833
109for the AJ 832/833,
110.It Cm epson
111for the Epson FX80,
112.It Cm itoh
113for the C:ITOH Prowriter
114.It Cm nec
115for the NEC-55?0/77?0 Spinwriter, with the Courier-72/Manifold
116thimble,
117.It Cm nec-t
118for the NEC-55?0/77?0 Spinwriter, with the Tech-Math/Times-Roman
119thimble,
120.It Cm nec25-t
121for the NEC-5525/7725 Spinwriter, with the Tech-Math/Times-Roman
122thimble,
123.It Cm qume
124for the Qume Sprint 5 or 9,
125.It Cm x-ecs
126for the Xerox/Diablo 1730/630, extended character set,
127.It Cm xerox
128for the Xerox 17?0 or the Diablo 16?0.
129Most of these also have versions for 12 pitch.
130See
131.Pa /usr/libdata/term/README
132for more information.
133.El
134.It Fl e
135Produce equally-spaced words in adjusted lines, using full terminal resolution.
136.It Fl h
137Use output tabs during horizontal spacing
138to speed output and reduce output character count.
139Tab settings are assumed to be every 8 nominal character widths.
140.El
141.Sh FILES
142.Bl -tag -width /usr/share/tmac/tmac.* -compact
143.It Pa /tmp/ta*
144Temporary file.
145.It Pa /usr/share/tmac/tmac.*
146Standard macro files
147.It Pa /usr/libdata/term/*
148Terminal driving tables for
149.Nm nroff .
150.El
151.Sh SEE ALSO
152.Xr troff 1 ,
153.Xr eqn 1 ,
154.Xr tbl 1 ,
155.Xr ms 7 ,
156.Xr me 7 ,
157.Xr man 7 ,
158.Xr col 1
159.Rs
160.%A J. F. Ossanna
161.%T "Nroff/Troff user's manual"
162.Re
163.Rs
164.%A B. W. Kernighan
165.%T A TROFF Tutorial
166.Re
167.Sh HISTORY
168An
169.Nm nroff
170command appeared in
171.At v6 .
172The version described here appeared in
173.At v7 .
174