summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/eplain/base/install.texi
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/eplain/base/install.texi')
-rw-r--r--Master/texmf-dist/doc/eplain/base/install.texi65
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.