|
|
1.1 root 1: .th ROFF I 6/12/72
2: .sh NAME
3: roff \*- format text
4: .sh SYNOPSIS
5: .bd roff
6: [ \fB+\fIn\fR ] [ \fB\*-\fIn\fR ] [
7: .bd \*-s
8: ] [
9: .bd \*-h
10: ] file ...
11: .sh DESCRIPTION
12: .it Roff
13: formats text according to control lines embedded
14: in the text in the given files.
15: Encountering a nonexistent file terminates printing.
16: Incoming interconsole messages are turned off during printing.
17: The optional flag arguments mean:
18: .s3
19: .lp +5 5
20: \fB+\fIn\fR Start printing at the first page with number \fIn\fR.
21: .s3
22: .lp +5 5
23: \fB\*-\fIn\fR Stop printing at the first page numbered higher
24: than \fIn\fR.
25: .s3
26: .lp +5 5
27: \fB\*-s\fR Stop before each page (including the first)
28: to allow paper manipulation;
29: resume on receipt of an interrupt signal.
30: .s3
31: .lp +5 5
32: \fB\*-h\fR Insert tabs in the output stream to replace
33: spaces whenever appropriate.
34: .s3
35: .i0
36: A Request Summary is attached.
37: .sh FILES
38: /usr/lib/suftab suffix hyphenation tables
39: .br
40: /tmp/rtm? temporary
41: .br
42: .sh "SEE ALSO"
43: nroff (I), troff (I)
44: .sh BUGS
45: .it Roff
46: is the simplest of the runoff
47: programs, but is virtually
48: undocumented.
49: .bp
50: .tc |
51: .tr |
52: .in 0
53: .ce
54: REQUEST SUMMARY
55: .s3
56: .ul
57: .if t .ta .75i 1.5i 2.25i
58: .if n .ta 8 16 24 32
59: Request Break Initial Meaning
60: .if t .in2.25i
61: .if n .in24
62: .na
63: .ti 0
64: .li
65: .ad yes yes Begin adjusting right margins.
66: .ti 0
67: .li
68: .ar no arabic Arabic page numbers.
69: .ti 0
70: .li
71: .br yes - Causes a line break \*- the filling of
72: the current line is stopped.
73: .ti 0
74: .li
75: .bl|n yes - Insert of n blank lines, on new page if necessary.
76: .ti 0
77: .li
78: .bp|+n yes n=1 Begin new page and number it n; no n means `+1'.
79: .ti 0
80: .li
81: .cc|c no c=. Control character becomes `c'.
82: .ti 0
83: .li
84: .ce|n yes - Center the next n input lines,
85: without filling.
86: .ti 0
87: .li
88: .de|xx no - Define macro named `xx'
89: (definition ends on line beginning `\fB..\fR').
90: .ti 0
91: .li
92: .ds yes no Double space; same as `.ls 2'.
93: .ti 0
94: .li
95: .ef|t no t=\*a\*a\*a\*a Even foot title becomes t.
96: .ti 0
97: .li
98: .eh|t no t=\*a\*a\*a\*a Even head title becomes t.
99: .ti 0
100: .li
101: .fi yes yes Begin filling output lines.
102: .ti 0
103: .li
104: .fo no t=\*a\*a\*a\*a All foot titles are t.
105: .ti 0
106: .li
107: .hc|c no none Hyphenation character set to `c'.
108: .ti 0
109: .li
110: .he|t no t=\*a\*a\*a\*a All head titles are t.
111: .ti 0
112: .li
113: .hx no - Title lines are suppressed.
114: .ti 0
115: .li
116: .hy|n no n=1 Hyphenation is done, if n=1;
117: and is not done, if n=0.
118: .ti 0
119: .li
120: .ig no - Ignore input lines through
121: a line beginning with `\fB..\fR'.
122: .ti 0
123: .li
124: .in|+n yes - Indent n spaces from left margin.
125: .ti 0
126: .li
127: .ix +n no - Same as `.in' but without break.
128: .ti 0
129: .li
130: .li|n no - Literal, treat next n lines as text.
131: .ti 0
132: .li
133: .ll|+n no n=65 Line length including indent is n characters.
134: .ti 0
135: .li
136: .ls|+n yes n=1 Line spacing set to n lines per output line.
137: .ti 0
138: .li
139: .m1|n no n=2 Put n blank lines between the top
140: of page and head title.
141: .ti 0
142: .li
143: .m2|n no n=2 n blank lines put between head title
144: and beginning of text on page.
145: .ti 0
146: .li
147: .m3|n no n=1 n blank lines put between end of
148: text and foot title.
149: .ti 0
150: .li
151: .m4|n no n=3 n blank lines put between the foot title
152: and the bottom of page.
153: .ti 0
154: .li
155: .na yes no Stop adjusting the right margin.
156: .ti 0
157: .li
158: .ne|n no - Begin new page, if n output lines
159: cannot fit on present page.
160: .ti 0
161: .li
162: .nn|+n no - The next n output lines are not numbered.
163: .ti 0
164: .li
165: .n1 no no Number output lines; start with 1 each page
166: .ti 0
167: .li
168: .n2|n no no Number output lines; stop numbering if n=0.
169: .ti 0
170: .li
171: .ni|+n no n=0 Line numbers are indented n.
172: .ti 0
173: .li
174: .nf yes no Stop filling output lines.
175: .ti 0
176: .li
177: .nx|filename - Change to input file `filename'.
178: .ti 0
179: .li
180: .of|t no t=\*a\*a\*a\*a Odd foot title becomes t.
181: .ti 0
182: .li
183: .oh|t no t=\*a\*a\*a\*a Odd head title becomes t.
184: .ti 0
185: .li
186: .pa|+n yes n=1 Same as `.bp'.
187: .ti 0
188: .li
189: .pl|+n no n=66 Total paper length taken to be n lines.
190: .ti 0
191: .li
192: .po|+n no n=0 Page offset.
193: All lines are preceded by N spaces.
194: .ti 0
195: .li
196: .ro no arabic Roman page numbers.
197: .ti 0
198: .li
199: .sk|n no - Produce n blank pages starting next page.
200: .ti 0
201: .li
202: .sp|n yes - Insert block of n blank lines.
203: .ti 0
204: .li
205: .ss yes yes Single space output lines,
206: equivalent to `.ls 1'.
207: .ti 0
208: .li
209: .ta|N|M|... - Pseudotab settings.
210: Initial tab settings are columns 9,17,25,...
211: .ti 0
212: .li
213: .tc|c no c=`|' Tab replacement character becomes `c'.
214: .ti 0
215: .li
216: .ti|+n yes - Temporarily indent next output
217: line n space.
218: .ti0
219: .li
220: .tr|abcd.. no - Translate a into b, c into d, etc.
221: .ti0
222: .li
223: .ul|n no - Underline the letters and numbers
224: in the next n input lines.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.