Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 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)