groff: Macro Directories
2.3 Macro Directories
=====================
A macro file must have a name in the form 'NAME.tmac' or 'tmac.NAME' and
be placed in a "tmac directory" to be found by the '-mNAME' command-line
option.(1) (⇒Macro Directories-Footnote-1) Together, these
directories constitute the "tmac path". Each directory is searched in
the following order until the desired macro file is found or the list is
exhausted.
* Directories specified with GNU 'troff''s or 'groff''s '-M'
command-line option.
* Directories listed in the 'GROFF_TMAC_PATH' environment variable.
* The current working directory (only if in unsafe mode using the
'-U' command-line option).
* The user's home directory, 'HOME'.
* A platform-dependent directory, a site-local (platform-independent)
directory, and the main tmac 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/lib/groff/site-tmac
/usr/local/share/groff/site-tmac
/usr/local/share/groff/1.23.0/tmac
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.