diff options
Diffstat (limited to 'Master/texmf-dist/doc/eplain/base/install.texi')
-rw-r--r-- | Master/texmf-dist/doc/eplain/base/install.texi | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/eplain/base/install.texi b/Master/texmf-dist/doc/eplain/base/install.texi new file mode 100644 index 00000000000..10cc42057ef --- /dev/null +++ b/Master/texmf-dist/doc/eplain/base/install.texi @@ -0,0 +1,65 @@ +@c This is part of the Eplain manual. Public domain. + +@node Installation +@chapter Installation + +@cindex Eplain, installing +@ @cindex installation +The simplest way to install Eplain is simply to install the file +@file{eplain.tex} in a directory where @TeX{} will find it. What that +directory is obviously depends on your operating system and @TeX{} +installation. I personally install @file{eplain.tex} in +a directory @file{/usr/local/lib/texmf/tex/plain}. + +If you want, you can also create a format (@file{.fmt}) +@pindex .fmt @r{file} +@cindex format file +file for Eplain, which will eliminate the time spent reading the macro +source file with @code{\input}. You do this by issuing a sequence of +Unix commands something like this: + +@example +prompt$ touch eplain.aux +prompt$ initex +This is TeX, ... +**&plain eplain +(eplain.tex) +*\dump +... @var{messages} ... +@end example + +@pindex eplain.aux +@cindex undefined labels, warnings about +@noindent You must make sure that @file{eplain.aux} exists @emph{before} you +run @file{initex}; otherwise, warning messages about undefined labels +will never be issued. + +You then have to install the resulting @file{eplain.fmt} in some system +directory or set an environment variable to tell @TeX{} how to find it. +I install the format files in @file{/usr/local/lib/texmf/ini}; the +environment variable for the Web2C port of @TeX{} to Unix is +@code{TEXFORMATS}. + +Some implementations of @TeX{} (including Web2C) use the name by which +@TeX{} is invoked to determine what format to read. For them, you +should make a link to the @file{virtex} program named @file{etex}, and +then install the format file with the name @file{etex.fmt}. This lets +users invoke @TeX{} as @file{etex} and get the format file read +automatically, without having to say @samp{&eplain}. + +For convenience, the file @file{etex.tex} in the distribution directory +does @code{\input eplain} and then @code{\dump}, so that if you replace +@samp{eplain} with @samp{etex} in the example above, the format file +will end up with the right name. + +The @code{install} target in the @file{Makefile} does all this properly +for Unix systems and Web2C. You may have to change the pathnames. + +@cindex emtex, installation under +Under emtex, @samp{eaj@@acpub.duke.edu} says that + +@example +tex386 -i ^&plain eplain \dump +@end example + +@noindent produces a format file. |