Debian Codegraph @

texmf-dist/doc/man/man1/mktextfm.1

raw
1 .TH MKTEXTFM 1 "30 January 2020" "TeX Live" "User Commands"
2 .\"=====================================================================
3 .if t .ds MF Metafont
4 .if n .ds MF Metafont
5 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
6 .if n .ds TX TeX
7 .\"=====================================================================
8 .SH NAME
9 mktextfm \- create a TFM file for a font
10 .SH SYNOPSIS
11 .B mktextfm
12 .RI [ options ]
13 .I font
14 .\"=====================================================================
15 .SH DESCRIPTION
16 .B mktextfm
17 is used to generate a tfm file from the \*(MF source files for
18 .IR font ,
19 or
20 .BR hbf2gf (1),
21 if possible. If
22 .I destdir
23 is given, the generated file will be installed there, otherwise a
24 (rather complicated) heuristic is used. If the tfm file already exists
25 in the destination location, this is reported and nothing is done.
26 .PP
27 If a GF (Generic Font) bitmap file is also generated, as is typical with
28 \(*MF, it is converted to PK (Packed Font) and installed similarly.
29 .PP
30 The full pathname of the generated file is printed on standard output.
31 .PP
32 If available, the
33 .BR mf-nowin (1)
34 variant of \*(MF is used to generate fonts to avoid the possibility of
35 online display.
36 .PP
37 .B mktextfm
38 is typically called by other programs, via Kpathsea, rather than from
39 the command line.
40 .\"=====================================================================
41 .SH OPTIONS
42 .B mktextfm
43 accepts the following options:
44 .TP
45 .BI --destdir \ dir
46 A directory name. If the directory is absolute, it is used as-is.
47 Otherwise, it is appended to the root destination directory set in the
48 script.
49 .TP
50 .B --help
51 Print help message and exit successfully.
52 .TP
53 .B --version
54 Print version information and exit successfully.
55 .\"=====================================================================
56 .SH ENVIRONMENT
57 One environment variable is specific to
58 .BR mktextfm :
59 .BR MF_MODE_EXTRA_INFO .
60 If this is set to a non-empty value, a \*(MF macro
61 .B mode_include_extra_info
62 will be invoked when the font is made. The standard
63 .B modes.mf
64 file defines this, as of modes.mf version 4.0, released in 2020.
65 This causes the so-called Xerox-world information, notably including the
66 .B CODINGSCHEME
67 for the font, to be included in the tfm file. (This is not done by
68 default since it is too intrusive to redefine the necessary primitives,
69 per Don Knuth.) The
70 .BR mftrace (1)
71 program, for example, can use this to get a clue about the font
72 encoding, although the information is not always perfectly definitive or
73 unambiguous.
74 .PP
75 For more about the encodings of \*(MF fonts, see the section ``Bitmap
76 font encodings'' in the Dvips manual (e.g.,
77 https://tug.org/texinfohtml/dvips.html).
78 .PP
79 The many other environment variables and various configuration files
80 that control a \*(TX system also affect the behavior of
81 .BR mktextfm ,
82 as usual.
83 .\"=====================================================================
84 .SH "SEE ALSO"
85 .BR mf (1),
86 .BR mktexmf (1),
87 .BR mktexpk (1).
88 .\"=====================================================================
89 .SH "REPORTING BUGS"
90 Report bugs to: [email protected] (https://lists.tug.org/tex-k)
91 .br
92 \*(TX Live home page: https://tug.org/texlive/