1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
|
.TH INITEX 1 "27 December 1992"
.\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP for troff
.el .ds OX TeX for nroff
.\" the same but obliqued
.\" BX definition must follow TX so BX can use TX
.if t .ds BX \fRB\s-2IB\s0\fP\*(TX
.if n .ds BX BibTeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
.\"=====================================================================
.SH NAME
initex \- initial TeX for making format (.fmt) files
.SH DESCRIPTION
.B initex
is a special version of the \*(TX program that has
no preloaded macro packages, but is capable of
converting a macro package into a special
preformatted binary file, called a
.I format
.RI ( .fmt )
file. That format file can subsequently be read
at high speed by
.BR virtex .
.PP
Major macro packages may require \*(TX to process
many thousands of lines of macros, and open and
read scores of font files, all of which would
contribute to a sizable startup overhead if the
job had to be done every time \*(TX was run.
.B initex
allows \*(TX to do the job once, and then save the
results in a binary format file that can be later
loaded more rapidly by
.BR virtex .
.PP
.B initex
is normally required only at the time \*(TX is
installed, or whenever major macro packages are
updated. Thus, it will be rare for anyone but
system installers to invoke it. Nevertheless, it
is just a normal program without special
privileges, so ordinary users can use it to
prepare a private format file.
.PP
Here is how you can ask
.B initex
to prepare format files for several major
packages:
.PP
For plain
.BR tex :
.RS
.nf
.I "initex 'plain \\\\dump'"
.I "mv plain.fmt tex.fmt"
.fi
The single quotes are necessary to protect
the backslash from interpretation as a Unix shell
escape character.
.RE
.PP
For
.BR amstex :
.RS
.nf
.I "initex '&tex amstex \\\\dump'"
.fi
The single quotes around the first argument
protect the ampersand from interpretation as a
Unix shell background request.
.RE
.PP
For
.BR etex :
.RS
.nf
.I "initex '&tex eplain \\\\dump'"
.I "mv eplain.fmt etex.fmt"
.fi
.RE
.PP
For
.BR lamstex :
.RS
.nf
.I "initex '&tex amstexl \\\\input lamstex \\\\dump'"
.I "mv amstexl.fmt lamstex.fmt"
.fi
.RE
.PP
For
.BR latex :
.RS
.nf
.I "initex 'lplain \\\\dump'"
.I "mv lplain.fmt latex.fmt"
.fi
.RE
.PP
For
.BR slitex :
.RS
.nf
.I "initex 'splain \\\\dump'"
.I "mv splain.fmt slitex.fmt"
.fi
.RE
.PP
For
.BR texinfo :
.RS
.nf
.I "initex '&tex texinfo @dump'"
.fi
The last argument is different from the previous
examples because
.B texinfo
redefines the \*(TX escape character from
backslash to at-sign. As for
.BR amstex ,
the file
.I tex.fmt
must already be available.
.RE
.PP
Note that several of these require that the format file for plain
\*(TX be available, since the first argument word
.I &tex
asks for the loading of the file
.IR tex.fmt .
.PP
It does not matter whether the command-line arguments are passed as a
single argument, or as separate arguments, since \*(TX reconstructs
the command line anyway.
.\"=====================================================================
.SH "SEE ALSO"
.BR amslatex (1),
.BR amstex (1),
.BR lamstex (1),
.BR latex (1),
.BR slitex (1),
.BR tex (1),
.BR virtex (1).
|