Go to the first, previous, next, last section, table of contents.

Installation

@cindex 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.


Go to the first, previous, next, last section, table of contents.