Warning: Attempt to read property "date" on null in /usr/local/www/websvn.planix.org/blame.php on line 247

Warning: Attempt to read property "msg" on null in /usr/local/www/websvn.planix.org/blame.php on line 247
WebSVN – planix.SVN – Blame – /os/branches/feature-vt/sys/src/cmd/postscript/trofftable/trofftable.1 – Rev 2

Subversion Repositories planix.SVN

Rev

Go to most recent revision | Details | 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 TROFFTABLE 1 "DWB 3.2"
4 
.SH NAME
5 
.B trofftable
6 
\- output a PostScript program that builds a font width table
7 
.SH SYNOPSIS
8 
\*(mBtrofftable\f1
9 
.OP "" options []
10 
.OP "" shortname
11 
.OP "" longname []
12 
.SH DESCRIPTION
13 
.B trofftable
14 
writes a PostScript program on the standard output that builds a
15 
font width table or typesetter description file.
16 
The following
17 
.I options
18 
are understood:
19 
.TP 1.0i
20 
.OP \-t name
21 
Use
22 
.I name
23 
as the template for fonts not in the default set.
24 
Choose
25 
.MW R
26 
for proportionally spaced fonts and
27 
.MW CW
28 
for fixed width fonts.
29 
Try
30 
.MW ZD
31 
(ZapfDingbats) if the font has a non-standard
32 
character set.
33 
The default is
34 
.MR R .
35 
.TP 1.0i
36 
.OP \-C file
37 
Copy
38 
.I file
39 
into each PostScript table program;
40 
.I file
41 
must contain legitimate PostScript.
42 
.TP 1.0i
43 
.OP \-H hostdir
44 
Use
45 
.I hostdir
46 
as the host resident font directory.
47 
A file in
48 
.I hostdir
49 
that matches the name of the troff font is assumed to be a host
50 
resident font program and is included in the PostScript width
51 
table program.
52 
There is no default.
53 
.TP 1.0i
54 
.OP \-L file
55 
Use
56 
.I file
57 
as the PostScript prologue.
58 
.br
59 
The default is
60 
.MW \*(dQ/trofftable.ps
61 
.TP 1.0i
62 
.OP \-S file
63 
Use
64 
.I file
65 
as the shell library file.
66 
Overrides the choice made with the
67 
.OP \-T
68 
option.
69 
.TP 1.0i
70 
.OP \-T name
71 
Set the target device to
72 
.IR name .
73 
Device
74 
.I name
75 
means
76 
.br
77 
.MI \*(dF/dev name /shell.lib
78 
is the shell library file.
79 
There is no default.
80 
.PP
81 
One of
82 
.OP \-T
83 
or
84 
.OP \-S
85 
is required.
86 
If both are given
87 
.OP \-S
88 
wins.
89 
Either
90 
.OP \-H
91 
or
92 
.OP \-C
93 
can be used to include a host resident font.
94 
.PP
95 
The shell library file defines a collection of functions used to
96 
build troff tables.
97 
The default set of tables is the list of names returned by the
98 
.MW AllTables
99 
function.
100 
Changes to the default list can be made by updating the
101 
.MW BuiltinTables
102 
function.
103 
.PP
104 
.I Shortname
105 
is the name of the
106 
.B troff
107 
font and
108 
.I longname
109 
is the name of the PostScript font;
110 
.I longname
111 
can be omitted only if
112 
.I shortname
113 
is a default table name.
114 
PostScript table programs created by
115 
.B trofftable
116 
return data to the host computer using PostScript's
117 
.MW print
118 
operator.
119 
See
120 
.BR hardcopy (1)
121 
if you don't have access to the printer's serial port.
122 
.SH EXAMPLES
123 
Get the PostScript program that builds a width table for font
124 
.MR R :
125 
.EX
126 
trofftable -Tpost R >R.ps
127 
.EE
128 
If a font is not in the default set include the
129 
.B troff
130 
and PostScript font names:
131 
.EX
132 
trofftable -TLatin1 GL Garamond-Light >GL.ps
133 
.EE
134 
A font must be available on the printer when the table is built.
135 
Use
136 
.OP \-H
137 
or
138 
.OP \-C
139 
to include host resident fonts.
140 
.SH WARNINGS
141 
A width table will not build properly if the printer cannot access
142 
the PostScript font.
143 
.PP
144 
The
145 
.OP -TLatin1
146 
option only works on PostScript printers that support the full
147 
.SM ISO
148 
Latin-1 character set.
149 
The error message from older printers will likely indicate a missing
150 
.MW ISOLatin1Encoding
151 
array.
152 
.SH FILES
153 
.MW \*(dF/dev*/shell.lib
154 
.br
155 
.MW \*(dQ/dpost.ps
156 
.br
157 
.MW \*(dQ/trofftable.ps
158 
.SH SEE ALSO
159 
.BR dpost (1),
160 
.BR hardcopy (1),
161 
.BR postio (1),
162 
.BR troff (1),
163 
.BR buildtables (1),
164 
.BR font (5)