groff: Font Directories
2.4 Font Directories
====================
'groff' enforces few restrictions on how font description files are
named. For its family/style mechanism to work (⇒Font Families),
the names of fonts within a family should start with the family name,
followed by the style. For example, the Times family uses 'T' for the
family name and 'R', 'B', 'I', and 'BI' to indicate the styles 'roman',
'bold', 'italic', and 'bold italic', respectively. Thus the final font
names are 'TR', 'TB', 'TI', and 'TBI'.
Font description files are kept in "font directories", which together
constitute the "font path". The search procedure always appends the
directory 'dev'NAME, where NAME is the name of the output device.
Assuming TeX DVI output, and '/foo/bar' as a font directory, the font
description files for 'grodvi' must be in '/foo/bar/devdvi'. Each
directory in the font path is searched in the following order until the
desired font description file is found or the list is exhausted.
* Directories specified with GNU 'troff''s or 'groff''s '-f'
command-line option. All output drivers (and some preprocessors)
support this option as well, because they require information about
the glyphs to be rendered in the document.
* Directories listed in the 'GROFF_FONT_PATH' environment variable.
* A site-local directory and the main font description directory.
The locations corresponding to your installation are listed in
section "Environment" of 'gtroff(1)'. If not otherwise configured,
they are as follows.
/usr/local/share/groff/site-font
/usr/local/share/groff/1.23.0/font
The foregoing assumes that the version of 'groff' is 1.23.0, and
that the installation prefix was '/usr/local'. It is possible to
fine-tune these locations during the source configuration process.