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