AFMTODIT(1) AFMTODIT(1)
NAME
afmtodit - create font files for use with groff -Tps
SYNOPSIS
afmtodit [ -nsv ] [ -ddesc_file ] [ -eenc_file ] [ -in ] [ -an ]
afm_file map_file font
DESCRIPTION
afmtodit creates a font file for use with groff and grops. afmtodit is
written in perl; you must have perl version 3 or newer installed in
order to run afmtodit. afm_file is the AFM (Adobe Font Metric) file
for the font. map_file is a file that says which groff character names
map onto each PostScript character name; this file should contain a
sequence of lines of the form
ps_char groff_char
where ps_char is the PostScript name of the character and groff_char is
the groff name of the character (as used in the groff font file). The
same ps_char can occur multiple times in the file; each groff_char must
occur at most once. Lines starting with # and blank lines are ignored.
font is the groff name of the font. If a PostScript character is in
the encoding to be used for the font but is not mentioned in map_file
then afmtodit will put it in the groff font file as an unnamed charac-
ter, which can be accessed by the \N escape sequence in troff. The
groff font file will be output to a file called font.
If there is a downloadable font file for the font, it may be listed in
the file /usr/share/groff/1.18.1/font/devps/download; see grops(1).
If the -i option is used, afmtodit will automatically generate an
italic correction, a left italic correction and a subscript correction
for each character (the significance of these parameters is explained
in groff_font(5)); these parameters may be specified for individual
characters by adding to the afm_file lines of the form:
italicCorrection ps_char n
leftItalicCorrection ps_char n
subscriptCorrection ps_char n
where ps_char is the PostScript name of the character, and n is the
desired value of the corresponding parameter in thousandths of an em.
These parameters are normally needed only for italic (or oblique)
fonts.
OPTIONS
-v Print version.
-n Don't output a ligatures command for this font. Use this with
constant-width fonts.
-s The font is special. The effect of this option is to add the
special command to the font file.
-ddesc_file
The device description file is desc_file rather than the default
DESC.
-eenc_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).
-an Use n as the slant parameter in the font 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 characters from an italic
font have accents placed too far to the right over them, then
use the -a option to give the font a smaller slant.
-in Generate an italic correction for each character so that the
character's width plus the character's italic correction is
equal to n thousandths of an em plus the amount by which the
right edge of the character's bounding is to the right of the
character's 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 character equal
to n thousandths of an em plus the amount by which the left edge
of the character's bounding box is to the left of the charac-
ter's origin. The left italic correction may be negative.
This option is normally needed only with italic (or oblique)
fonts. The font files distributed with groff were created using
an option of -i50 for italic fonts.
FILES
/usr/share/groff/1.18.1/font/devps/DESC
Device description file.
/usr/share/groff/1.18.1/font/devps/F
Font description file for font F.
/usr/share/groff/1.18.1/font/devps/download
List of downloadable fonts.
/usr/share/groff/1.18.1/font/devps/text.enc
Encoding used for text fonts.
/usr/share/groff/1.18.1/font/devps/generate/textmap
Standard mapping.
SEE ALSO
groff(1), grops(1), groff_font(5), perl(1)
Groff Version 1.18.1 02 March 2002 AFMTODIT(1)
