1 .TH AFMTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
3 afmtodit \- create font files for use with groff \-Tps and \-Tpdf
6 .\" --------------------------------------------------------------------
10 Copyright \[co] 1989-2014 Free Software Foundation, Inc.
12 Permission is granted to make and distribute verbatim copies of
13 this manual provided the copyright notice and this permission notice
14 are preserved on all copies.
16 Permission is granted to copy and distribute modified versions of this
17 manual under the conditions for verbatim copying, provided that the
18 entire resulting derived work is distributed under the terms of a
19 permission notice identical to this one.
21 Permission is granted to copy and distribute translations of this
22 manual into another language, under the above conditions for modified
23 versions, except that this permission notice may be included in
24 translations approved by the Free Software Foundation instead of in
28 .\" --------------------------------------------------------------------
31 .\" Like TP, but if specified indent is more than half
32 .\" the current line-length - indent, use the default indent.
34 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
39 . ie \\n(.$-1 .RI "[\ \fB\\$1\fP\ " "\\$2" "\ ]"
40 . el .RB "[\ " "\\$1" "\ ]"
43 .\" --------------------------------------------------------------------
45 .\" --------------------------------------------------------------------
50 .in +\w'\fBafmtodit 'u
68 The whitespace between a command line option and its argument is optional.
71 .\" --------------------------------------------------------------------
73 .\" --------------------------------------------------------------------
76 creates a font file for use with groff,
83 you must have perl version 5.004 or newer installed in order to run
89 is the AFM (Adobe Font Metric) file for the font.
94 is a file that says which groff character names map onto
95 each PostScript character name;
96 this file should contain a sequence of lines of the form
103 is the PostScript name of the character and
105 is the groff name of the character (as used in the groff font file).
109 can occur multiple times in the file;
112 must occur at most once.
116 and blank lines are ignored.
118 If the file isn\[aq]t found in the current directory, it is searched
119 in the \[oq]devps/generate\[cq] subdirectory of the default font
124 If a PostScript character is not mentioned in
126 and a generic groff glyph name can't be deduced using the Adobe Glyph
127 List (AGL, built into
131 puts the PostScript character into the groff font file as an unnamed
132 character which can only be accessed by the
137 In particular, this is true for glyph variants like \[oq]foo.bar\[cq];
138 all glyph names containing one or more periods are mapped to unnamed
143 is not specified, the encoding defined in the AFM file (i.e., entries
144 with non-negative character codes) is used.
146 Please refer to section \[oq]Using Symbols\[cq] in the groff info file
147 which describes how groff glyph names are constructed.
151 Characters not encoded in the AFM file (i.e., entries which have \-1
152 as the character code) are still available in groff; they get glyph
153 index values greater than 255 (or greater than the biggest character
154 code used in the AFM file in the unlikely case that it is greater than
155 255) in the groff font file.
157 Glyph indices of unencoded characters don\[aq]t have a specific order;
158 it is best to access them with glyph names only.
162 The groff font file will be output to a file called
170 If there is a downloadable font file for the font, it may be listed in
172 .BR @FONTDIR@/devps/download ;
174 .BR grops (@MAN1EXT@).
182 will automatically generate an italic correction,
183 a left italic correction and a subscript correction
185 (the significance of these parameters is explained in
186 .BR groff_font (@MAN5EXT@));
187 these parameters may be specified for individual characters by
192 .BI italicCorrection\ ps_char\ n
194 .BI leftItalicCorrection\ ps_char\ n
196 .BI subscriptCorrection\ ps_char\ n
200 is the PostScript name of the character,
203 is the desired value of the corresponding parameter in thousandths of an em.
205 These parameters are normally needed only for italic (or oblique) fonts.
208 .\" --------------------------------------------------------------------
210 .\" --------------------------------------------------------------------
216 as the slant parameter in the font file;
217 this is used by groff in the positioning of accents.
221 uses the negative of the ItalicAngle specified in the afm file;
222 with true italic fonts it is sometimes desirable to use
223 a slant that is less than this.
225 If you find that characters from an italic font have accents
226 placed too far to the right over them,
229 option to give the font a smaller slant.
233 Include comments in the font file in order to identify the PS font.
237 The device description file is
239 rather than the default
242 If not found in the current directory, the \[oq]devps\[qc]
243 subdirectory of the default font directory is searched (this is true
244 for both the default device description file and a file given with
250 The PostScript font should be reencoded to use the encoding described
256 .BR grops (@MAN1EXT@).
258 If not found in the current directory, the \[oq]devps\[cq]
259 subdirectory of the default font directory is searched.
263 The internal name of the groff font is set to
268 Generate an italic correction for each character so that the
269 character's width plus the character's italic correction is equal to
272 plus the amount by which the right edge of the character's bounding box
273 is to the right of the character\[aq]s origin.
275 If this would result in a negative italic correction, use a zero
276 italic correction instead.
279 Also generate a subscript correction equal to the
280 product of the tangent of the slant of the font and
281 four fifths of the x-height of the font.
283 If this would result in a subscript correction greater than the italic
284 correction, use a subscript correction equal to the italic correction
288 Also generate a left italic correction for each character
292 plus the amount by which the left edge of the character's bounding box
293 is to the left of the character\[aq]s origin.
295 The left italic correction may be negative unless option
300 This option is normally needed only with italic (or oblique) fonts.
302 The font files distributed with groff were created using an option of
315 Omit any kerning data from the groff font.
317 This should be used only for mono-spaced fonts.
321 Prevent negative left italic correction values.
323 Roman font files distributed with groff were created with
325 to improve spacing with
326 .BR @g@eqn (@MAN1EXT@).
332 command for this font.
334 Use this with constant-width fonts.
340 The effect of this option is to add the
342 command to the font file.
350 Don't use the built-in Adobe Glyph List.
353 .\" --------------------------------------------------------------------
355 .\" --------------------------------------------------------------------
357 .Tp \w'\fB@FONTDIR@/devps/download'u+2n
358 .B @FONTDIR@/devps/DESC
359 Device description file.
362 .BI @FONTDIR@/devps/ F
363 Font description file for font
367 .B @FONTDIR@/devps/download
368 List of downloadable fonts.
371 .B @FONTDIR@/devps/text.enc
372 Encoding used for text fonts.
375 .B @FONTDIR@/devps/generate/textmap
379 .\" --------------------------------------------------------------------
381 .\" --------------------------------------------------------------------
383 .BR groff (@MAN1EXT@),
384 .BR grops (@MAN1EXT@),
385 .BR groff_font (@MAN5EXT@),
390 The groff info file, section \[oq]Using Symbols\[cq].
393 .\" --------------------------------------------------------------------
395 .\" --------------------------------------------------------------------