2 Copyright (C) 1989-2000, 2001, 2002, 2003, 2005, 2006, 2008, 2009
3 Free Software Foundation, Inc.
5 Permission is granted to make and distribute verbatim copies of
6 this manual provided the copyright notice and this permission notice
7 are preserved on all copies.
9 Permission is granted to copy and distribute modified versions of this
10 manual under the conditions for verbatim copying, provided that the
11 entire resulting derived work is distributed under the terms of a
12 permission notice identical to this one.
14 Permission is granted to copy and distribute translations of this
15 manual into another language, under the above conditions for modified
16 versions, except that this permission notice may be included in
17 translations approved by the Free Software Foundation instead of in
22 .\" Like TP, but if specified indent is more than half
23 .\" the current line-length - indent, use the default indent.
25 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
30 . ie \\n(.$-1 .RI "[\ \fB\\$1\fP\ " "\\$2" "\ ]"
31 . el .RB "[\ " "\\$1" "\ ]"
35 .TH AFMTODIT @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
39 afmtodit \- create font files for use with groff \-Tps
46 .in +\w'\fBafmtodit 'u
62 The whitespace between a command line option and its argument is optional.
66 creates a font file for use with groff and
71 you must have perl version 5.004 or newer installed in order to run
76 is the AFM (Adobe Font Metric) file for the font.
80 is a file that says which groff character names map onto
81 each PostScript character name;
82 this file should contain a sequence of lines of the form
89 is the PostScript name of the character
92 is the groff name of the character (as used in the groff font file).
96 can occur multiple times in the file;
99 must occur at most once.
103 and blank lines are ignored.
105 If the file isn't found in the current directory, it is searched in
106 the `devps/generate' subdirectory of the default font directory.
109 If a PostScript character is not mentioned in
111 and a generic groff glyph name can't be deduced using the
112 Adobe Glyph List (AGL, built into
116 puts the PostScript character into the groff font file as an unnamed
117 character which can only be accessed by the
121 In particular, this is true for glyph variants like `foo.bar'; all glyph
122 names containing one or more periods are mapped to unnamed entities.
126 is not specified, the encoding defined in the AFM file (i.e., entries
127 with non-negative character codes) is used.
129 Please refer to section `Using Symbols' in the groff info file which
130 describes how groff glyph names are constructed.
133 Characters not encoded in the AFM file (i.e., entries which have \-1 as
134 the character code) are still available in groff; they get glyph index
135 values greater than 255 (or greater than the biggest character code used
136 in the AFM file in the unlikely case that it is greater than 255) in the
139 Glyph indices of unencoded characters don't have a specific order; it
140 is best to access them with glyph names only.
143 The groff font file will be output to a file called
147 If there is a downloadable font file for the font, it may be listed in
149 .BR @FONTDIR@/devps/download ;
151 .BR grops (@MAN1EXT@).
158 will automatically generate an italic correction,
159 a left italic correction and a subscript correction
161 (the significance of these parameters is explained in
162 .BR groff_font (@MAN5EXT@));
163 these parameters may be specified for individual characters by
168 .BI italicCorrection\ ps_char\ n
170 .BI leftItalicCorrection\ ps_char\ n
172 .BI subscriptCorrection\ ps_char\ n
176 is the PostScript name of the character,
179 is the desired value of the corresponding parameter in thousandths of an em.
181 These parameters are normally needed only for italic (or oblique) fonts.
189 as the slant parameter in the font file;
190 this is used by groff in the positioning of accents.
194 uses the negative of the ItalicAngle specified in the afm file;
195 with true italic fonts it is sometimes desirable to use
196 a slant that is less than this.
198 If you find that characters from an italic font have accents
199 placed too far to the right over them,
202 option to give the font a smaller slant.
206 Include comments in the font file in order to identify the PS font.
210 The device description file is
212 rather than the default
215 If not found in the current directory, the `devps' subdirectory of the
216 default font directory is searched (this is true for both the default
217 device description file and a file given with option
222 The PostScript font should be reencoded to use the encoding described
228 .BR grops (@MAN1EXT@).
230 If not found in the current directory, the `devps' subdirectory of the
231 default font directory is searched.
235 The internal name of the groff font is set to
240 Generate an italic correction for each character so that
241 the character's width plus the character's italic correction
245 plus the amount by which the right edge of the character's bounding box
246 is to the right of the character's origin.
248 If this would result in a negative italic correction, use a zero
249 italic correction instead.
252 Also generate a subscript correction equal to the
253 product of the tangent of the slant of the font and
254 four fifths of the x-height of the font.
256 If this would result in a subscript correction greater than the italic
257 correction, use a subscript correction equal to the italic correction
261 Also generate a left italic correction for each character
265 plus the amount by which the left edge of the character's bounding box
266 is to the left of the character's origin.
268 The left italic correction may be negative unless option
273 This option is normally needed only with italic (or oblique) fonts.
275 The font files distributed with groff were created using an option of
281 Omit any kerning data from the groff font.
282 This should be used only for mono-spaced fonts.
286 Prevent negative left italic correction values.
288 Roman font files distributed with groff were created with
290 to improve spacing with
291 .BR @g@eqn (@MAN1EXT@).
297 command for this font.
299 Use this with constant-width fonts.
305 The effect of this option is to add the
307 command to the font file.
315 Don't use the built-in Adobe Glyph List.
319 .Tp \w'\fB@FONTDIR@/devps/download'u+2n
320 .B @FONTDIR@/devps/DESC
321 Device description file.
324 .BI @FONTDIR@/devps/ F
325 Font description file for font
329 .B @FONTDIR@/devps/download
330 List of downloadable fonts.
333 .B @FONTDIR@/devps/text.enc
334 Encoding used for text fonts.
337 .B @FONTDIR@/devps/generate/textmap
342 .BR groff (@MAN1EXT@),
343 .BR grops (@MAN1EXT@),
344 .BR groff_font (@MAN5EXT@),
348 The groff info file, section `Using Symbols'.