Provided by: groff_1.23.0-3build2_amd64 
Name
afmtodit - adapt Adobe Font Metrics files for groff PostScript and PDF output
Synopsis
afmtodit [-ckmnsx] [-a slant] [-d device-description-file] [-e encoding-file]
[-f internal-name] [-i italic-correction-factor] [-o output-file] [-w space-
width] afm-file map-file font-description-file
afmtodit --help
afmtodit -v
afmtodit --version
Description
afmtodit adapts an Adobe Font Metric file, afm-file, for use with the ps and pdf output
devices of troff(1). map-file associates a groff ordinary or special character name with
a PostScript glyph name. Output is written in groff_font(5) format to font-description-
file, a file named for the intended groff font name (but see the -o option).
map-file should contain a sequence of lines of the form
ps-glyph groff-char
where ps-glyph is the PostScript glyph name and groff-char is a groff ordinary (if of unit
length) or special (if longer) character identifier. The same ps-glyph can occur multiple
times in the file; each groff-char must occur at most once. Lines starting with “#” and
blank lines are ignored. If the file isn't found in the current directory, it is sought
in the devps/generate subdirectory of the default font directory.
If a PostScript glyph is not mentioned in map-file, and a groff character name can't be
deduced using the Adobe Glyph List (AGL, built into afmtodit), then afmtodit puts the
PostScript glyph into the groff font description file as an unnamed glyph which can only
be accessed by the “\N” escape sequence in a roff document. In particular, this is true
for glyph variants named in the form “foo.bar”; all glyph names containing one or more
periods are mapped to unnamed entities. Unless -e is specified, the encoding defined in
the AFM file (i.e., entries with non-negative codes) is used. Refer to section “Using
Symbols” in Groff: The GNU Implementation of troff, the groff Texinfo manual, or
groff_char(7), which describe how groff character identifiers are constructed.
Glyphs not encoded in the AFM file (i.e., entries indexed as “-1”) are still available in
groff; they get glyph index values greater than 255 (or greater than the biggest code used
in the AFM file in the unlikely case that it is greater than 255) in the groff font
description file. Unencoded glyph indices don't have a specific order; it is best to
access them only via special character identifiers.
If the font file proper (not just its metrics) is available, listing it in the files /usr/
share/groff/1.23.0/font/devps/download and /usr/share/groff/1.23.0/font/devpdf/download
enables it to be embedded in the output produced by grops(1) and gropdf(1), respectively.
If the -i option is used, afmtodit automatically generates an italic correction, a left
italic correction, and a subscript correction for each glyph (the significance of these is
explained in groff_font(5)); they can be specified for individual glyphs by adding to the
afm-file lines of the form:
italicCorrection ps-glyph n
leftItalicCorrection ps-glyph n
subscriptCorrection ps-glyph n
where ps-glyph is the PostScript glyph name, and n is the desired value of the
corresponding parameter in thousandths of an em. Such parameters are normally needed only
for italic (or oblique) fonts.
The -s option should be given if the font is “special”, meaning that groff should search
it whenever a glyph is not found in the current font. In that case, font-description-file
should be listed as an argument to the fonts directive in the output device's DESC file;
if it is not special, there is no need to do so, since troff(1) will automatically mount
it when it is first used.
Options
--help displays a usage message, while -v and --version show version information; all exit
afterward.
-a slant
Use slant as the slant (“angle”) parameter in the font description file; this is
used by groff in the positioning of accents. By default afmtodit uses the negative
of the ItalicAngle specified in the AFM file; with true italic fonts it is
sometimes desirable to use a slant that is less than this. If you find that an
italic font places accents over base glyphs too far to the right, use -a to give it
a smaller slant.
-c Include comments in the font description file identifying the PostScript font.
-d device-description-file
The device description file is desc-file rather than the default DESC. If not
found in the current directory, the devps subdirectory of the default font
directory is searched (this is true for both the default device description file
and a file given with option -d).
-e encoding-file
The PostScript font should be reencoded to use the encoding described in enc-file.
The format of enc-file is described in grops(1). If not found in the current
directory, the devps subdirectory of the default font directory is searched.
-f internal-name
The internal name of the groff font is set to name.
-i italic-correction-factor
Generate an italic correction for each glyph so that its width plus its italic
correction is equal to italic-correction-factor thousandths of an em plus the
amount by which the right edge of the glyph's bounding box is to the right of its
origin. If this would result in a negative italic correction, use a zero italic
correction instead.
Also generate a subscript correction equal to the product of the tangent of the
slant of the font and four fifths of the x-height of the font. If this would
result in a subscript correction greater than the italic correction, use a
subscript correction equal to the italic correction instead.
Also generate a left italic correction for each glyph equal to italic-correction-
factor thousandths of an em plus the amount by which the left edge of the glyph's
bounding box is to the left of its origin. The left italic correction may be
negative unless option -m is given.
This option is normally needed only with italic (or oblique) fonts. The font
description files distributed with groff were created using an option of -i50 for
italic fonts.
-o output-file
Write to output-file instead of font-description-file.
-k Omit any kerning data from the groff font; use only for monospaced (constant-width)
fonts.
-m Prevent negative left italic correction values. Font description files for roman
styles distributed with groff were created with “-i0 -m” to improve spacing with
eqn(1).
-n Don't output a ligatures command for this font; use with monospaced (constant-
width) fonts.
-s Add the special directive to the font description file.
-w space-width
Use space-width as the with of inter-word spaces.
-x Don't use the built-in Adobe Glyph List.
Files
/usr/share/groff/1.23.0/font/devps/DESC
describes the ps output device.
/usr/share/groff/1.23.0/font/devps/F
describes the font known as F on device ps.
/usr/share/groff/1.23.0/font/devps/download
lists fonts available for embedding within the PostScript document (or download to
the device).
/usr/share/groff/1.23.0/font/devps/generate/dingbats.map
/usr/share/groff/1.23.0/font/devps/generate/dingbats-reversed.map
/usr/share/groff/1.23.0/font/devps/generate/slanted-symbol.map
/usr/share/groff/1.23.0/font/devps/generate/symbol.map
/usr/share/groff/1.23.0/font/devps/generate/text.map
map names in the Adobe Glyph List to groff special character identifiers for Zapf
Dingbats (ZD), reversed Zapf Dingbats (ZDR), slanted symbol (SS), symbol (S), and
text fonts, respectively. These map-files are used to produce the font description
files provided with groff for the grops output driver.
Diagnostics
AGL name 'x' already mapped to groff name 'y'; ignoring AGL name 'uniXXXX'
You can disregard these if they're in the form shown, where the ignored AGL name
contains four hexadecimal digits XXXX. The Adobe Glyph List (AGL) has its own
names for glyphs; they are often different from groff's special character names.
afmtodit is constructing a mapping from groff special character names to AGL names;
this can be a one-to-one or many-to-one mapping, but one-to-many will not work, so
afmtodit discards the excess mappings. For example, if x is *D, y is Delta, and z
is uni0394, afmtodit is telling you that the groff font description that it is
writing cannot map the groff special character \[*D] to AGL glyphs Delta and
uni0394 at the same time.
If you get a message like this but are unhappy with which mapping is ignored, a
remedy is to craft an alternative map-file and re-run afmtodit using it.
See also
Groff: The GNU Implementation of troff, by Trent A. Fisher and Werner Lemberg, is the
primary groff manual. Section “Using Symbols” may be of particular note. You can browse
it interactively with “info '(groff)Using Symbols'”.
groff(1), gropdf(1), grops(1), groff_font(5)