Debian Codegraph @

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

raw
1 .TH MFT 1 "7 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if n .ds MP MetaPost
4 .if t .ds MP MetaPost
5 .if n .ds MF Metafont
6 .if t .ds MF Metafont
7 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
8 .if n .ds TX TeX
9 .\"=====================================================================
10 .SH NAME
11 mft \- translate Metafont or MetaPost code to TeX for prettyprinting
12 .SH SYNOPSIS
13 .B mft
14 .RI [ options ]
15 .BR \fIsource_file\fP [ .mf | .mp ]
16 .\"=====================================================================
17 .SH DESCRIPTION
18 The
19 .B mft
20 program creates a \*(TX file from a \*(MF or \*(MP program.
21 It takes appropriate care of typographic details like page
22 layout and the use of indentation, italics, boldface, etc., as illustrated
23 in the book \fIComputer Modern Typefaces\fP by Donald Knuth.
24 .PP
25 Special conventions in \*(MF and \*(MP comments allow you to control
26 things that would not otherwise come out right; section 1 of the
27 \fBmft\fP source program and the mft section in the Web2C manual
28 explain these rules.
29 .PP
30 The
31 .B mft
32 program uses an optional change file (which works just as the change files to
33 .BR tangle (1)
34 and
35 .BR weave (1)
36 do)
37 and one or several style files (which are prepended to everything).
38 If no style file is specified, the style file
39 .B plain.mft
40 for \*(MF, or
41 .B mplain.mft
42 for \*(MP, is used. These files are specified via the options below.
43 .PP
44 The \fIsource_file\fP, as well as any change and style files, are
45 searched for using the MFINPUTS (for \*(MF) or MPINPUTS (for \*(MP) and
46 MFTINPUTS environment variables if you have set them, or else the
47 corresponding system defaults.
48 .PP
49 The output \*(TX file name is formed by using
50 .B .tex
51 in place of the extension of
52 .IR source_file .
53 .\"=====================================================================
54 .SH OPTIONS
55 See
56 .BR tex (1)
57 for details of command-line parsing.
58 .TP
59 .BI -change= change_file \fR[\fP.ch\fR]\fP
60 Apply the change file
61 .I change_file
62 to
63 .IR mf_file .
64 .PP
65 .TP
66 .B -metapost
67 Consider
68 .I source_file
69 to be a \*(MP source file; this is the default if
70 .I mf_file
71 has the extension
72 .BR .mp .
73 .PP
74 .TP
75 .BI -style= style_file \fR[\fP.mft\fR]\fP
76 Use the style file
77 .I style_file
78 instead of
79 .B plain.mft
80 or
81 .BR mplain.mft ;
82 this option can be given more than once.
83 .PP
84 The standard
85 .B -help
86 and
87 .B -version
88 options are also supported.
89 .\"=====================================================================
90 .SH FILES
91 .TP
92 .I mftmac.tex\fR,\fP mptmac.tex
93 \*(TX macros used by the output from \fBmft\fP for Metafont and
94 MetaPost input, respectively.
95 .TP
96 .IR plain.mft ", " mplain.mft
97 Default style files.
98 .TP
99 .I cmbase.mft
100 Style file for Computer Modern.
101 .TP
102 .I e.mft
103 Style file for Knuth's Volume E: Computer Modern Typefaces.
104 .\"=====================================================================
105 .SH "SEE ALSO"
106 .BR mf (1),
107 .BR mpost (1),
108 .BR weave (1).
109 .br
110 Donald E. Knuth,
111 .I Computer Modern Typefaces
112 (Volume E of
113 .IR "Computers & Typesetting" ).
114 .br
115 Donald E. Knuth et al.,
116 .IR \*(MFware .
117 .PP
118 Package page on CTAN: https://ctan.org/pkg/mft
119 .br
120 Section in the Web2c manual:
121 https://tug.org/texinfohtml/web2c.html#mft-invocation
122 .br
123 Typeset source code, including the typesetting controls:
124 https://ctan.org/pkg/knuth-pdf
125 .\"=====================================================================
126 .SH AUTHORS
127 Donald E. Knuth wrote and still maintains the program. He ported it to
128 Unix with the help of Pierre MacKay and the Unix port of
129 .B weave
130 by Howard Trickey and Pavel Curtis.
131 .PP
132 Public discussion list and bug reports: https://lists.tug.org/tex-k