summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/eplain/base/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/eplain/base/INSTALL')
-rw-r--r--Master/texmf-dist/doc/eplain/base/INSTALL51
1 files changed, 51 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/eplain/base/INSTALL b/Master/texmf-dist/doc/eplain/base/INSTALL
new file mode 100644
index 00000000000..3a514ae606b
--- /dev/null
+++ b/Master/texmf-dist/doc/eplain/base/INSTALL
@@ -0,0 +1,51 @@
+Installation
+************
+
+The simplest way to install Eplain is simply to install the 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 `eplain.tex' in a directory
+`/usr/local/lib/texmf/tex/plain'.
+
+ If you want, you can also create a format (`.fmt') file for Eplain,
+which will eliminate the time spent reading the macro source file with
+`\input'. You do this by issuing a sequence of Unix commands something
+like this:
+
+ prompt$ touch eplain.aux
+ prompt$ initex
+ This is TeX, ...
+ **&plain eplain
+ (eplain.tex)
+ *\dump
+ ... MESSAGES ...
+
+You must make sure that `eplain.aux' exists _before_ you run `initex';
+otherwise, warning messages about undefined labels will never be issued.
+
+ You then have to install the resulting `eplain.fmt' in some system
+directory or set an environment variable to tell TeX how to find it. I
+install the format files in `/usr/local/lib/texmf/ini'; the environment
+variable for the Web2C port of TeX to Unix is `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 `virtex' program named `etex', and then install the
+format file with the name `etex.fmt'. This lets users invoke TeX as
+`etex' and get the format file read automatically, without having to
+say `&eplain'.
+
+ For convenience, the file `etex.tex' in the distribution directory
+does `\input eplain' and then `\dump', so that if you replace `eplain'
+with `etex' in the example above, the format file will end up with the
+right name.
+
+ The `install' target in the `Makefile' does all this properly for
+Unix systems and Web2C. You may have to change the pathnames.
+
+ Under emtex, `eaj@acpub.duke.edu' says that
+
+ tex386 -i ^&plain eplain \dump
+
+produces a format file.
+