|
|
1.1 root 1: .TH TROFF 5
2: .CT 1 writing_output
3: .SH NAME
4: troff \- device-independent output
5: .SH DESCRIPTION
6: .IR Troff (1)
7: produces an ASCII representation of a typeset document,
8: expressed in the following syntax.
9: Strings inside
10: .B [
11: .B ]
12: are optional.
13: The string
14: .B \en
15: represents newline.
16: White space (spaces or newlines) may occur
17: between commands and is sometimes necessary to terminate numbers.
18: .PP
19: .TP
20: .BI s n
21: Set point size to
22: .I n.
23: .PD 0
24: .TP
25: .BI f n
26: Use font in position
27: .I n.
28: Normally fonts
29: are mounted starting at position 1; 0 is reserved.
30: .I troff.
31: .TP
32: .BI c x
33: Place character
34: .I x
35: at the current location on the page;
36: .I x
37: is a single ASCII character.
38: .TP
39: .BI C name
40: Place special character.
41: The
42: .I name
43: of the character is delimited by white space.
44: .TP
45: .BI H n
46: Go to horizontal location
47: .I n,
48: expressed in basic units.
49: .TP
50: .BI h n
51: Add
52: .I n
53: to the current horizontal location (relative goto).
54: .TP
55: .BI V n
56: Go to vertical location
57: .I n,
58: measured positive downward.
59: .TP
60: .BI v n
61: Add
62: .I n
63: to the current vertical location.
64: .TP
65: .I nnx
66: A two-digit number followed by an ASCII character; equivalent to
67: .BI h nn c x.
68: .TP
69: .BI n b\ a
70: End of line.
71: No action is required;
72: .I troff
73: will explicitly reset the location.
74: Number
75: .IR b
76: is the amount of space before
77: the line,
78: .IR a ,
79: the amount of space after the line.
80: .TP
81: .B w
82: A
83: .B w
84: appears between words of the input document.
85: No action is
86: required.
87: .TP
88: .BI p n
89: Begin a new page with page number
90: .I n.
91: The vertical location on the page becomes 0.
92: .TP
93: .BI # \ .... \en
94: Comment.
95: .TP
96: .BI Dl " x y" \en
97: Draw a line from the current location by
98: .IR x , y .
99: .TP
100: .BI Dc " d" \en
101: Draw a circle of diameter
102: .I d
103: with the leftmost edge at the current location,
104: .IR x , y .
105: The current location becomes
106: .IR x + d , y .
107: .TP
108: .BI De " dx dy" \en
109: Draw an ellipse with
110: .IR x -axis
111: .I dx
112: and
113: .IR y -axis
114: .I dy.
115: The leftmost edge
116: of the ellipse will be at the current location.
117: The current location becomes
118: .IR x + dx , y .
119: .TP
120: .BI Da " x y u v" \en
121: Draw an arc counterclockwise from the current location to
122: .IR x + u,
123: .IR y + v,
124: with center offset
125: .IR x , y
126: from the current location.
127: The end of the arc becomes the current location.
128: .TP
129: .BI D~ " x y x y ..." \en
130: Draw a spline curve (wiggly line) from the
131: current location, moving by
132: .I x,y
133: each time.
134: The end of the curve becomes the current location.
135: .TP
136: .B x\ i[nit]\en
137: Initialize the typesetting device.
138: The actions required depend on the device.
139: .TP
140: .BI x\ T \ dest \en
141: The name of the typesetter is
142: .IR dest ,
143: as in option
144: .BR \-T
145: of
146: .IR troff (1).
147: .TP
148: .BI "x r[es]" " n h v" \en
149: The resolution of the typesetting device is
150: .IR n
151: units per inch.
152: Horizontal motions must be multiples of
153: .I h
154: units, vertical motions
155: .I v
156: units.
157: .TP
158: .B x p[ause]\en
159: Pause.
160: Cause the current page to finish but do not relinquish the
161: typesetter.
162: .TP
163: .B x s[top]\en
164: Stop.
165: Cause the current page to finish and then relinquish the typesetter.
166: .TP
167: .B x t[railer]\en
168: Generate a trailer if necessary.
169: .TP
170: .BI "x f[ont]" " n name" \en
171: Load font
172: .I name
173: into position
174: .IR n .
175: .TP
176: .BI "x H[eight] " n \en
177: Set the character height to
178: .I n
179: points.
180: This causes the letters
181: to be elongated or shortened.
182: It does not affect the width
183: of a letter.
184: Not all typesetters can do this.
185: .TP
186: .BI "x S[lant] " n \en
187: Set the slant to
188: .I n
189: degrees, if possible.
190: .TP
191: .BI x "..." \en
192: Arbitrary; may be used for device-specific functions.
193: .SH SEE ALSO
194: .IR troff (1),
195: .IR d202 (1),
196: .IR apsend (1),
197: .IR lp (1),
198: .IR proof (9.1)
199: .br
200: B. W. Kernighan,
201: .I "A Typesetter-Independent Troff
202: this manual, volume 2.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.