source/texk/web2c/man/mft.man

   1 .TH MFT 1 "16 June 2015" "Web2C @VERSION@"
   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.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
   8 .if n .ds TX TeX
   9 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP
  10 .el .ds OX TeX
  11 .\" BX definition must follow TX so BX can use TX
  12 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
  13 .if n .ds BX BibTeX
  14 .\" LX definition must follow TX so LX can use TX
  15 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
  16 .if n .ds LX LaTeX
  17 .\"=====================================================================
  18 .SH NAME
  19 mft \- translate Metafont or MetaPost code to TeX code for prettyprinting
  20 .SH SYNOPSIS
  21 .B mft
  22 .RI [ OPTIONS ]
  23 .BR \fImf_file_name\fP [ .mf | .mp ]
  24 .\"=====================================================================
  25 .SH DESCRIPTION
  26 This manual page is not meant to be exhaustive.  The complete
  27 documentation for this version of \*(TX can be found in the info file
  28 or manual
  29 .IR "Web2C: A TeX implementation" .
  30 .PP
  31 The
  32 .B mft
  33 program creates a \*(TX file from a \*(MF or \*(MP program.
  34 It takes appropriate care of typographic details like page
  35 layout and the use of indentation, italics, boldface, etc., as illustrated
  36 in the book
  37 .IR "Computer Modern Typefaces" .
  38 Special conventions in \*(MF and \*(MP comments allow you to control things that
  39 would not otherwise come out right; section 1 of the MFT source program
  40 in the
  41 .I \*(MFware
  42 report explains these rules.
  43 .PP
  44 The
  45 .B mft
  46 program uses an optional change file (which works just as the change files to
  47 .BR tangle (1)
  48 and
  49 .BR weave (1)
  50 do)
  51 and one or several style files (which are prepended to everything).
  52 If no style file is specified, the style file
  53 .B plain.mft
  54 for \*(MF (or
  55 .B mplain.mft
  56 for \*(MP) is automatically used.
  57 .PP
  58 The
  59 .IR mf_file_name ,
  60 optional
  61 .IR change_file_name ,
  62 and
  63 .I style_file_name
  64 files are searched for using the MFINPUTS (for \*(MF) or MPINPUTS (for
  65 \*(MP) and MFTINPUTS environment variables if you have set them, or else the
  66 corresponding system defaults.
  67 .PP
  68 The output \*(TX file name is formed by using
  69 .B .tex
  70 in place of the extension of
  71 .IR mf_file_name .
  72 .\"=====================================================================
  73 .SH OPTIONS
  74 .TP
  75 .BI \-change= change_file_name \fR[\fP.ch\fR]\fP
  76 Apply the change file
  77 .I change_file_name
  78 to
  79 .IR mf_file_name .
  80 .PP
  81 .TP
  82 .B \-metapost
  83 Assume
  84 .I mf_file_name
  85 is a \*(MP source file (this is the default if
  86 .I mf_file_name
  87 has the extension
  88 .BR .mp ).
  89 .PP
  90 .TP
  91 .BI \-style= style_file_name \fR[\fP.mft\fR]\fP
  92 Use the style file
  93 .I style_file_name
  94 insted of
  95 .B plain.mft
  96 (or
  97 .BR mplain.mft );
  98 this option can be given more than once.
  99 .\"=====================================================================
 100 .SH FILES
 101 .TP
 102 .I mftmac.tex
 103 \*(TX macros used by
 104 .B mft
 105 output.
 106 .TP
 107 .IR plain.mft ", " mplain.mft
 108 Default style files.
 109 .TP
 110 .I cmbase.mft
 111 Style file for Computer Modern.
 112 .\"=====================================================================
 113 .SH "SEE ALSO"
 114 .BR mf (1),
 115 .BR weave (1).
 116 .br
 117 Donald E. Knuth,
 118 .I Computer Modern Typefaces
 119 (Volume E of
 120 .IR "Computers and Typesetting" ),
 121 Addison-Wesley, 1986, ISBN 0-201-13446-2.
 122 .br
 123 Donald E. Knuth et al.,
 124 .IR \*(MFware .
 125 .\"=====================================================================
 126 .SH AUTHORS
 127 Donald E. Knuth wrote the program, and he ported it to Unix with the help of
 128 Pierre MacKay and the Unix port of
 129 .B weave
 130 by Howard Trickey and Pavel Curtis.
 131 The program is published in the
 132 .I \*(MFware
 133 technical report, available from the \*(TX Users Group.