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