This section gives a summary of the above explanations; it can
serve as a step-by-step font installation guide for gropdf.
• Convert your font to something groff understands. This is
either a PostScript Type 1 font in either PFA or PFB,
together with an AFM file.
The very first line in a PFA/PFB file contains this:
%!PS-AdobeFont-1.0:
A PFB file has this also in the first line, but the string
is preceded with some binary bytes.
• Convert the AFM file to a groff font description file with
the afmtodit(1) program. An example call is
afmtodit Foo-Bar-Bold.afm map/textmap FBB
which converts the metric file 'Foo-Bar-Bold.afm' to the
groff font 'FBB'. If you have a font family which comes
with normal, bold, italic, and bold italic faces, it is
recommended to use the letters R, B, I, and BI,
respectively, as postfixes in the groff font names to make
groff's '.fam' request work. An example is groff's built-
in Times-Roman font: The font family name is T, and the
groff font names are TR, TB, TI, and TBI.
• Install both the groff font description files and the
fonts in a 'devpdf' subdirectory of the font path which
groff finds. See section 'Environment' in troff(1) for
the actual value of the font path. Note that groff
doesn't use the AFM files (but it is a good idea to store
them anyway).
• Register all fonts which must be downloaded to the printer
in the devpdf/download file. Only the first occurrence of
this file in the font path is read. This means that you
should copy the default download file to the first
directory in your font path and add your fonts there. To
continue the above example we assume that the PS font name
for Foo-Bar-Bold.pfa is 'XY-Foo-Bar-Bold' (the PS font
name is stored in the internalname field in the FBB file)
and belongs to foundry 'F' thus the following line should
be added to download:
F XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
Use a tab character to separate the fields, and the
'foundry' field should be null for the default foundry.
