4 Copyright (c) 2014 - 2015 Steffen (Daode) Nurpmeso <sdaoden@users.sf.net>.
6 Copyright (C) 1989 - 2003, 2005, 2006, 2008
7 Free Software Foundation, Inc.
9 Permission is granted to make and distribute verbatim copies of
10 this manual provided the copyright notice and this permission notice
11 are preserved on all copies.
13 Permission is granted to copy and distribute modified versions of this
14 manual under the conditions for verbatim copying, provided that the
15 entire resulting derived work is distributed under the terms of a
16 permission notice identical to this one.
18 Permission is granted to copy and distribute translations of this
19 manual into another language, under the above conditions for modified
20 versions, except that this permission notice may be included in
21 translations approved by the Free Software Foundation instead of in
26 .\" Like TP, but if specified indent is more than half
27 .\" the current line-length - indent, use the default indent.
29 . ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
34 . ie \\n(.$-1 .RI "[\ \fB\\$1\fP\ " "\\$2" "\ ]"
35 . el .RB "[\ " "\\$1" "\ ]"
39 .TH @U_AFMTODIT@ @MAN1EXT@ "@MDATE@" "@T_ROFF@ v@VERSION@"
43 @L_AFMTODIT@ \- create font files for use with @L_ROFF@ \-Tps
50 .in +\w'\fB@L_AFMTODIT@ 'u
66 The whitespace between a command line option and its argument is optional.
70 creates a font file for use with @L_ROFF@ and
75 you must have perl version 5.004 or newer installed in order to run it.
79 is the AFM (Adobe Font Metric) file for the font.
83 is a file that says which groff character names map onto
84 each PostScript character name;
85 this file should contain a sequence of lines of the form
92 is the PostScript name of the character
95 is the @L_ROFF@ name of the character (as used in the @L_ROFF@ font file).
99 can occur multiple times in the file;
102 must occur at most once.
106 and blank lines are ignored.
108 If the file isn't found in the current directory, it is searched in
109 the `dev-ps/generate' subdirectory of the default font directory.
112 If a PostScript character is not mentioned in
114 and a generic @L_ROFF@ glyph name can't be deduced using the
115 Adobe Glyph List (AGL, built into
119 puts the PostScript character into the @L_ROFF@ font file as an unnamed
120 character which can only be accessed by the
124 In particular, this is true for glyph variants like `foo.bar'; all glyph
125 names containing one or more periods are mapped to unnamed entities.
129 is not specified, the encoding defined in the AFM file (i.e., entries
130 with non-negative character codes) is used.
132 Please refer to section `Using Symbols' in the @L_ROFF@ manual which
133 describes how groff glyph names are constructed.
136 Characters not encoded in the AFM file (i.e., entries which have \-1 as
137 the character code) are still available in @L_ROFF@; they get glyph index
138 values greater than 255 (or greater than the biggest character code used
139 in the AFM file in the unlikely case that it is greater than 255) in the
142 Glyph indices of unencoded characters don't have a specific order; it
143 is best to access them with glyph names only.
146 The @L_ROFF@ font file will be output to a file called
150 If there is a downloadable font file for the font, it may be listed in
152 .BR @FONTDIR@/dev-ps/download ;
154 .BR @L_D_PS@ (@MAN1EXT@).
161 will automatically generate an italic correction,
162 a left italic correction and a subscript correction
164 (the significance of these parameters is explained in
165 .BR @L_ROFF@_font (@MAN5EXT@));
166 these parameters may be specified for individual characters by
171 .BI italicCorrection\ ps_char\ n
173 .BI leftItalicCorrection\ ps_char\ n
175 .BI subscriptCorrection\ ps_char\ n
179 is the PostScript name of the character,
182 is the desired value of the corresponding parameter in thousandths of an em.
184 These parameters are normally needed only for italic (or oblique) fonts.
192 as the slant parameter in the font file;
193 this is used in the positioning of accents.
195 By default the negative of the ItalicAngle specified in the afm file is
196 used; with true italic fonts it is sometimes desirable to use
197 a slant that is less than this.
199 If you find that characters from an italic font have accents
200 placed too far to the right over them,
203 option to give the font a smaller slant.
207 Include comments in the font file in order to identify the PS font.
211 The device description file is
213 rather than the default
216 If not found in the current directory, the `dev-ps' subdirectory of the
217 default font directory is searched (this is true for both the default
218 device description file and a file given with option
223 The PostScript font should be reencoded to use the encoding described
229 .BR @L_D_PS@ (@MAN1EXT@).
231 If not found in the current directory, the `dev-ps' subdirectory of the
232 default font directory is searched.
236 The internal name of the @L_ROFF@ font is set to
241 Generate an italic correction for each character so that
242 the character's width plus the character's italic correction
246 plus the amount by which the right edge of the character's bounding box
247 is to the right of the character's origin.
249 If this would result in a negative italic correction, use a zero
250 italic correction instead.
253 Also generate a subscript correction equal to the
254 product of the tangent of the slant of the font and
255 four fifths of the x-height of the font.
257 If this would result in a subscript correction greater than the italic
258 correction, use a subscript correction equal to the italic correction
262 Also generate a left italic correction for each character
266 plus the amount by which the left edge of the character's bounding box
267 is to the left of the character's origin.
269 The left italic correction may be negative unless option
274 This option is normally needed only with italic (or oblique) fonts.
276 The font files distributed with groff were created using an option of
282 Omit any kerning data from the font.
283 This should be used only for mono-spaced fonts.
287 Prevent negative left italic correction values.
289 Roman font files distributed with @L_ROFF@ were created with
291 to improve spacing with
292 .BR @L_P_EQN@ (@MAN1EXT@).
298 command for this font.
300 Use this with constant-width fonts.
306 The effect of this option is to add the
308 command to the font file.
316 Don't use the built-in Adobe Glyph List.
320 .Tp \w'\fB@FONTDIR@/dev-ps/download'u+2n
321 .B @FONTDIR@/dev-ps/DESC
322 Device description file.
325 .BI @FONTDIR@/dev-ps/ F
326 Font description file for font
330 .B @FONTDIR@/dev-ps/download
331 List of downloadable fonts.
334 .B @FONTDIR@/dev-ps/text.enc
335 Encoding used for text fonts.
338 .B @FONTDIR@/dev-ps/generate/textmap
343 .BR @L_ROFF@ (@MAN1EXT@),
344 .BR @L_D_PS@ (@MAN1EXT@),
346 .BR @L_ROFF@_font (@MAN5EXT@)