Penguin
Recent Changes
Annotated edit history of afmtodit(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 AFMTODIT
2 !!!AFMTODIT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 SEE ALSO
9 ----
10 !!NAME
11
12
13 afmtodit - create font files for use with groff -Tps
14 !!SYNOPSIS
15
16
17 __afmtodit__ [[ __-nsv__ ] [[ __-d__''desc_file''
18 ] [[ __-e__''enc_file'' ] [[ __-i__''n'' ] [[
19 __-a__''n'' ] ''afm_file map_file
20 font''
21 !!DESCRIPTION
22
23
24 __afmtodit__ creates a font file for use with groff and
25 __grops__. __afmtodit__ is written in perl; you must
26 have perl version 3 installed in order to run
27 __afmtodit__. ''afm_file'' is the AFM (Adobe Font
28 Metric) file for the font. ''map_file'' is a file that
3 perry 29 says which groff character names map onto each !PostScript
1 perry 30 character name; this file should contain a sequence of lines
31 of the form
32
33
34 ''ps_char groff_char''
35
36
3 perry 37 where ''ps_char'' is the !PostScript name of the character
1 perry 38 and ''groff_char'' is the groff name of the character (as
39 used in the groff font file.) The same ''ps_char'' can
40 occur multiple times in the file; each ''groff_char''
41 must occur at most once. ''font'' is the groff name of
3 perry 42 the font. If a !PostScript character is in the encoding to be
1 perry 43 used for the font but is not mentioned in ''map_file''
44 then __afmtodit__ will put it in the groff font file as
45 an unnamed character, which can be accessed by the __N__
46 escape sequence in __troff__. The groff font file will be
47 output to a file called ''font''.
48
49
50 If there is a downloadable font file for the font, it may be
51 listed in the file
52 __/usr/share/groff/1.17.2/font/devps/download__; see
53 grops(1).
54
55
56 If the __-i__ option is used, __afmtodit__ will
57 automatically generate an italic correction, a left italic
58 correction and a subscript correction for each character
59 (the significance of these parameters is explained in
4 perry 60 groff_font(5)); these parameters may be specified for
1 perry 61 individual characters by adding to the ''afm_file'' lines
62 of the form:
63
64
65 __italicCorrection__ ''ps_char n''__
66 leftItalicCorrection__ ''ps_char n''__
67 subscriptCorrection__ ''ps_char n''
68
69
3 perry 70 where ''ps_char'' is the !PostScript name of the
1 perry 71 character, and ''n'' is the desired value of the
72 corresponding parameter in thousandths of an em. These
73 parameters are normally needed only for italic (or oblique)
74 fonts.
75 !!OPTIONS
76
77
78 __-v__
79
80
81 Print version.
82
83
84 __-n__
85
86
87 Don't output a __ligatures__ command for this font. Use
88 this with constant-width fonts.
89
90
91 __-s__
92
93
94 The font is special. The effect of this option is to add the
95 __special__ command to the font file.
96
97
98 __-d__''desc_file''
99
100
101 The device description file is ''desc_file'' rather than
102 the default __DESC__.
103
104
105 __-e__''enc_file''
106
107
3 perry 108 The !PostScript font should be reencoded to use the encoding
1 perry 109 described in enc_file. The format of ''enc_file'' is
110 described in grops(1).
111
112
113 __-a__''n''
114
115
116 Use ''n'' as the slant parameter in the font file; this
117 is used by groff in the positioning of accents. By default
3 perry 118 __afmtodit__ uses the negative of the !ItalicAngle
1 perry 119 specified in the afm file; with true italic fonts it is
120 sometimes desirable to use a slant that is less than this.
121 If you find that characters from an italic font have accents
122 placed too far to the right over them, then use the
123 __-a__ option to give the font a smaller
124 slant.
125
126
127 __-i__''n''
128
129
130 Generate an italic correction for each character so that the
131 character's width plus the character's italic correction is
132 equal to ''n'' thousandths of an em plus the amount by
133 which the right edge of the character's bounding is to the
134 right of the character's origin. If this would result in a
135 negative italic correction, use a zero italic correction
136 instead.
137
138
139 Also generate a subscript correction equal to the product of
140 the tangent of the slant of the font and four fifths of the
141 x-height of the font. If this would result in a subscript
142 correction greater than the italic correction, use a
143 subscript correction equal to the italic correction
144 instead.
145
146
147 Also generate a left italic correction for each character
148 equal to ''n'' thousandths of an em plus the amount by
149 which the left edge of the character's bounding box is to
150 the left of the character's origin. The left italic
151 correction may be negative.
152
153
154 This option is normally needed only with italic (or oblique)
155 fonts. The font files distributed with groff were created
156 using an option of __-i50__ for italic
157 fonts.
158 !!FILES
159
160
161 __/usr/share/groff/1.17.2/font/devps/DESC__
162
163
164 Device description file.
165
166
167 __/usr/share/groff/1.17.2/font/devps/__''F''
168
169
170 Font description file for font ''F''.
171
172
173 __/usr/share/groff/1.17.2/font/devps/download__
174
175
176 List of downloadable fonts.
177
178
179 __/usr/share/groff/1.17.2/font/devps/text.enc__
180
181
182 Encoding used for text fonts.
183
184
185 __/usr/share/groff/1.17.2/font/devps/generate/textmap__
186
187
188 Standard mapping.
189 !!SEE ALSO
190
191
4 perry 192 groff(1), grops(1), groff_font(5),
1 perry 193 perl(1)
194 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.