![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to buildtables.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / post.src / buildtables|
Return to buildtables.1 CVS log | Up to [Research Unix] / researchv10no / cmd / post.src / buildtables |
1.1 root 1: .ds dF /usr/lib/font
2: .ds dQ /usr/lib/postscript
3: .TH BUILDTABLES 1 "DWB 3.2"
4: .SH NAME
5: .B buildtables
6: \- build
7: .B troff
8: tables on a PostScript printer
9: .SH SYNOPSIS
10: \*(mBbuildtables\f1
11: .OP "" options []
12: .OP "" "name \(el" []
13: .SH DESCRIPTION
14: .B buildtables
15: builds font width tables or the typesetter description
16: file on a PostScript printer.
17: No arguments means build a default set of tables;
18: usually a superset of the LaserWriter Plus collection.
19: The following
20: .I options
21: are understood:
22: .TP 1.0i
23: .OP \-b speed
24: Transmit data over
25: .I line
26: at baud rate
27: .I speed.
28: Recognized baud rates are 1200, 2400, 4800, 9600, and 19200.
29: The default
30: .I speed
31: is 9600 baud.
32: .TP 1.0i
33: .OP \-l line
34: Build the tables on the PostScript printer attached to
35: .I line.
36: There is no default.
37: .TP 1.0i
38: .OP \-t name
39: Use
40: .I name
41: as the template for fonts not in the default set.
42: Choose
43: .MW R
44: for proportionally spaced fonts and
45: .MW CW
46: for fixed width fonts.
47: Try
48: .MW ZD
49: (ZapfDingbats) if the font has a non-standard
50: character set.
51: The default is
52: .MR R .
53: .TP 1.0i
54: .OP \-C file
55: Copy
56: .I file
57: into each PostScript table program;
58: .I file
59: must contain legitimate PostScript.
60: .TP 1.0i
61: .OP \-H hostdir
62: Use
63: .I hostdir
64: as the host-resident font directory.
65: A file in
66: .I hostdir
67: that matches the name of the
68: .B troff
69: font is assumed to be a host-resident font program and is included
70: in the PostScript width table program.
71: There is no default.
72: .TP 1.0i
73: .OP \-S file
74: Use
75: .I file
76: as the shell library file.
77: Overrides the choice made with the
78: .OP \-T
79: option.
80: .TP 1.0i
81: .OP \-T name
82: Set the target device to
83: .I name.
84: .br
85: Device
86: .I name
87: means
88: .ft 2
89: .MI \*(dF/dev name /shell.lib
90: .ft 1
91: is the shell library file.
92: There is no default.
93: .PP
94: If
95: .OP \-l
96: is omitted output files are the PostScript programs that
97: build the tables, rather than the tables themselves.
98: One of
99: .OP \-T
100: or
101: .OP \-S
102: is required.
103: If both are given
104: .OP \-S
105: wins.
106: Although
107: .OP \-H
108: is the preferred mechanism for including host-resident font files,
109: .OP \-C
110: makes sense when only one width table is built.
111: .PP
112: The shell library file defines a collection of functions used to
113: build
114: .BR troff (1)
115: tables.
116: The default set of tables is the list of names returned by the
117: .MW AllTables
118: function.
119: Changes to the default list can be made by updating the
120: .MW BuiltinTables
121: function.
122: .PP
123: Each
124: .B buildtables
125: argument
126: must be a default table name, or a pair of names enclosed in quotes.
127: If the argument is a pair, the first name is the
128: .B troff
129: font and the second is the full PostScript font name.
130: Tables are created in the current directory.
131: Each is assigned a name that matches the
132: .B troff
133: table name.
134: .PP
135: The PostScript table programs created by
136: .BR trofftable (1)
137: are written to files that have
138: .MW .ps
139: appended to the
140: .B troff
141: table name.
142: The
143: .MW .ps
144: file is deleted after the table is built.
145: Options not listed above are passed to
146: .B trofftable.
147: The PostScript table programs return data to the host computer using
148: PostScript's
149: .MW print
150: operator.
151: See
152: .BR hardcopy (1)
153: if you do not have access to the printer's serial port.
154: .SH EXAMPLES
155: .PP
156: Build the default collection of devpost tables on the printer
157: connected to
158: .MW /dev/tty00
159: (no font name arguments):
160: .EX
161: buildtables -l/dev/tty00 -Tpost
162: .EE
163: To do the same and to restrict the tables that are built,
164: Add
165: .B troff
166: font names (or
167: .MR DESC )
168: to restrict the tables built on the printer connected to
169: .MR /dev/tty00 :
170: .EX
171: buildtables -l/dev/tty00 -Tpost R I B BI DESC S
172: .EE
173: Enclose the
174: .B troff
175: and PostScript font names in quotes to
176: build the width table for a font not in the default set
177: (also on the printer connected to
178: .MR /dev/tty00 ):
179: .EX
180: buildtables -l/dev/tty00 -TLatin1 "GL Garamond-Light"
181: .EE
182: A font must be available on the printer when the table is built.
183: Use
184: .OP \-H
185: or
186: .OP \-C
187: to include host-resident fonts.
188: .SH WARNINGS
189: .PP
190: A width table will not build properly if the printer cannot access
191: the PostScript font.
192: .PP
193: The
194: .OP \-TLatin1
195: option only works on PostScript printers that support the full
196: .SM ISO
197: Latin-1 character set.
198: The error message from older printers will likely indicate a missing
199: .MW ISOLatin1Encoding
200: array.
201: .SH FILES
202: .MW \*(dF/dev*/shell.lib
203: .br
204: .MW \*(dQ/dpost.ps
205: .br
206: .MW \*(dQ/trofftable.ps
207: .br
208: .SH SEE ALSO
209: .BR dpost (1),
210: .BR hardcopy (1),
211: .BR postio (1),
212: .BR troff (1),
213: .BR trofftable (1),
214: .BR font (5)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.