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 character,
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.4/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.