1MKTEXTFM(1)                      User Commands                     MKTEXTFM(1)
2
3
4

NAME

6       mktextfm - create a TFM file for a font
7

SYNOPSIS

9       mktextfm [options] font
10

DESCRIPTION

12       mktextfm  is used to generate a tfm file from the Metafont source files
13       for font, or hbf2gf(1), if possible.  If destdir is given,  the  gener‐
14       ated  file  will  be  installed there, otherwise a (rather complicated)
15       heuristic is used.  If the tfm file already exists in  the  destination
16       location, this is reported and nothing is done.
17
18       If  a  GF  (Generic  Font) bitmap file is also generated, as is typical
19       with ΜF, it is converted to PK (Packed Font) and installed similarly.
20
21       The full pathname of the generated file is printed on standard output.
22
23       If available, the mf-nowin(1) variant of Metafont is used  to  generate
24       fonts to avoid the possibility of online display.
25
26       mktextfm  is  typically  called by other programs, via Kpathsea, rather
27       than from the command line.
28

OPTIONS

30       mktextfm accepts the following options:
31
32       --destdir dir
33              A directory name. If the directory is absolute, it is  used  as-
34              is.  Otherwise, it is appended to the root destination directory
35              set in the script.
36
37       --help Print help message and exit successfully.
38
39       --version
40              Print version information and exit successfully.
41

ENVIRONMENT

43       One environment variable is specific to  mktextfm:  MF_MODE_EXTRA_INFO.
44       If   this   is   set   to   a   non-empty   value,   a  Metafont  macro
45       mode_include_extra_info will be invoked when the  font  is  made.   The
46       standard  modes.mf  file  defines  this,  as  of  modes.mf version 4.0,
47       released in 2020.  This causes the so-called  Xerox-world  information,
48       notably  including the CODINGSCHEME for the font, to be included in the
49       tfm file. (This is not done by default since it  is  too  intrusive  to
50       redefine  the necessary primitives, per Don Knuth.) The mftrace(1) pro‐
51       gram, for example, can use this to get a clue about the font  encoding,
52       although  the  information  is not always perfectly definitive or unam‐
53       biguous.
54
55       For more about the encodings of Metafont fonts, see the section  ``Bit‐
56       map  font encodings'' in the Dvips manual (e.g., https://tug.org/texin
57       fohtml/dvips.html).
58
59       The many other environment variables and  various  configuration  files
60       that  control  a  TeX  system  also affect the behavior of mktextfm, as
61       usual.
62

SEE ALSO

64       mf(1), mktexmf(1), mktexpk(1).
65

REPORTING BUGS

67       Report bugs to: tex-k@tug.org (https://lists.tug.org/tex-k)
68       TeX Live home page: https://tug.org/texlive/
69
70
71
72TeX Live                        30 January 2020                    MKTEXTFM(1)
Impressum