This section summarizes the above explanations; it can serve as a
step-by-step font-installation guide for grops.
• Convert your font to something groff understands. This is
either a PostScript Type 1 font in PFA format or a
PostScript Type 42 font, together with an AFM file.
The very first characters in a PFA file look like this:
%!PS-AdobeFont-1.0:
A PFB file has this also in the first line, but the string
is preceded with some binary bytes.
The very first characters in a Type 42 font file look like
this:
%!PS-TrueTypeFont
This is a wrapper format for TrueType fonts. Old PS
printers might not support it (that is, they might not
have a built-in TrueType font interpreter).
If your font is in PFB format (such fonts normally have
.pfb as the file extension), you might use groff's
pfbtops(1) program to convert it to PFA. For TrueType
fonts, try ttftot42 or fontforge. For all other font
formats use fontforge which can convert most outline font
formats.
• Convert the AFM file to a groff font description file with
the afmtodit(1) program. An example call is
afmtodit Foo-Bar-Bold.afm 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 devps 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 devps/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),
thus the following line should be added to download.
XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
