![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to troff.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / roff / troff|
Return to troff.1 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / roff / troff |
1.1 root 1: .\" @(#)troff.1 6.1 (Berkeley) 4/29/85
2: .\"
3: .TH TROFF 1 "April 29, 1985"
4: .AT 3
5: .SH NAME
6: troff, nroff \- text formatting and typesetting
7: .SH SYNOPSIS
8: .B troff
9: [ option ] ...
10: [ file ] ...
11: .PP
12: .B nroff
13: [ option ] ...
14: [ file ] ...
15: .SH DESCRIPTION
16: .I Troff
17: formats text in the named
18: .I files
19: for printing on a Graphic Systems C/A/T phototypesetter;
20: .I nroff
21: is used for for typewriter-like devices.
22: Their capabilities are described in the
23: .I Nroff/Troff user's manual.
24: .PP
25: If no
26: .I file
27: argument is present, the standard input is read.
28: An argument consisting of a single minus
29: .RB ( \- )
30: is taken to be a file name corresponding to the standard input.
31: The options, which may appear in any order so long as they appear
32: before the files, are:
33: .TP "\w'\f3\-m\f1name 'u"
34: .BI \-o list
35: Print only pages whose page numbers appear in the comma-separated
36: .I list
37: of numbers and ranges.
38: A range
39: .IB N \- M
40: means pages
41: .I N
42: through
43: .IR M ;
44: an initial
45: .I \-N
46: means from the beginning to page
47: .IR N ;
48: and a final
49: .IR N \-
50: means from
51: .I N
52: to the end.
53: .TP
54: .BI \-n N
55: Number first generated page
56: .IR N .
57: .TP
58: .BI \-s N
59: Stop every
60: .I N
61: pages.
62: .I Nroff
63: will halt prior to every
64: .I N
65: pages (default
66: .IR N =1)
67: to allow paper loading or changing, and will resume upon receipt of a newline.
68: .I Troff
69: will stop the phototypesetter every
70: .I N
71: pages, produce a trailer to allow changing cassettes,
72: and resume when the typesetter's start button is pressed.
73: .TP
74: .BI \-m name
75: Prepend the macro file
76: .BI /usr/lib/tmac/tmac. name
77: to the input
78: .IR files .
79: .TP
80: .BI \-r aN
81: Set register
82: .I a
83: (one-character) to
84: .IR N .
85: .TP
86: .B \-i
87: Read standard input after the input files are exhausted.
88: .TP
89: .B \-q
90: Invoke the simultaneous input-output mode of the
91: .B rd
92: request.
93: .HP
94: .bd I 3
95: .I Troff only
96: .br
97: .bd I
98: .TP
99: .B \-t
100: Direct output to the standard output instead of the phototypesetter.
101: .TP
102: .B \-f
103: Refrain from feeding out paper and stopping
104: phototypesetter at the end of the run.
105: .TP
106: .B \-w
107: Wait until phototypesetter is available, if currently busy.
108: .TP
109: .B \-b
110: Report whether the phototypesetter is busy or available.
111: No text processing is done.
112: .TP
113: .B \-a
114: Send a printable ASCII approximation of the results to the standard output.
115: .TP
116: .BR \-p N
117: Print all characters in point size
118: .I N
119: while retaining all prescribed spacings and motions,
120: to reduce phototypesetter elapsed time.
121: .TP
122: .BI \-F fontdir
123: The directory
124: .I fontdir
125: contains the font width tables instead of the default directory
126: /usr/lib/fonts. This option can be used to produce output for devices
127: besides the phototypesetter.
128: .PP
129: If the file
130: .I /usr/adm/tracct
131: is writable,
132: .I troff
133: keeps phototypesetter accounting records there.
134: The integrity of that file may be secured by making
135: .I troff
136: a 'set user-id' program.
137: .SH FILES
138: .ta \w'/usr/lib/tmac/tmac.* 'u
139: /tmp/ta* temporary file
140: .br
141: /usr/lib/tmac/tmac.* standard macro files
142: .br
143: /usr/lib/term/* terminal driving tables for
144: .I nroff
145: .br
146: /usr/lib/font/* font width tables for
147: .I troff
148: .br
149: /dev/cat phototypesetter
150: .br
151: /usr/adm/tracct accounting statistics for /dev/cat
152: .SH "SEE ALSO"
153: J. F. Ossanna,
154: .I Nroff/Troff user's manual
155: .br
156: B. W. Kernighan,
157: .I
158: A TROFF Tutorial
159: .br
160: eqn(1), tbl(1), ms(7), me(7), man(7), col(1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.