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