| 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/ |