source/texk/web2c/man/initex.min

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