diff options
Diffstat (limited to 'Master/texmf-dist/doc/eplain/INSTALL')
| -rw-r--r-- | Master/texmf-dist/doc/eplain/INSTALL | 58 |
1 files changed, 25 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/eplain/INSTALL b/Master/texmf-dist/doc/eplain/INSTALL index dcd705281b6..8c726e7c0e9 100644 --- a/Master/texmf-dist/doc/eplain/INSTALL +++ b/Master/texmf-dist/doc/eplain/INSTALL @@ -1,46 +1,38 @@ Installation +Invoking Eplain +Installation +Invoking Eplain +Installation ************ Your TeX installation should already contain a version of Eplain -(`eplain.tex') in its main `texmf' tree (usually under -`/usr/share/texmf/tex/eplain/' on Unix systems). To install a newer -version of Eplain, put the new `eplain.tex' (included in Eplain -distributions) in the `tex/eplain/' subdirectory of your local `texmf' -tree. The newer version you install in the local tree should override -the older one in the main tree. - - The location of the local `texmf' tree obviously depends on your -operating system and TeX installation. On Unix systems the usual -location is `/usr/local/share/texmf/'. If you don't have write -permissions for `/usr/local/share/texmf/', many installations read the -`texmf' tree in the user's home directory; `eplain.tex' then should go -under `~/texmf/tex/eplain/'. For more information about TeX directory -structure, please see -`http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds'. - - If you prefer to install `eplain.tex' in a non-standard place, set -an environment variable (`TEXINPUTS' for the Web2C port of TeX to Unix) -to tell TeX how to find it. - - 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 +('eplain.tex') in its main 'texmf' tree; with TeX Live, it's in +'.../texmf-dist/tex/eplain/eplain.tex'. + + Generally, you can just use that version and there is no need to do +anything else. But if you want to use a newer version of Eplain for a +given document, you can put the new 'eplain.tex' in the document's +directory, and it will be found. + + If you want to install a new 'eplain.tex' in some other place, set an +environment variable (commonly, 'TEXINPUTS') to tell TeX how to find it. + + Distributions should also create and maintain the 'eplain.fmt' file +file. But if you want to do it yourself, you can: + + $ touch eplain.aux + $ initex This is TeX, ... **&plain eplain (eplain.tex) *\dump ... MESSAGES ... -You must make sure that `eplain.aux' exists _before_ you run `initex'; +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 your local -`texmf' tree or set an environment variable to tell TeX how to find it. -For the Web2C port of TeX to Unix, format files are usually installed -under `/usr/local/share/texmf/web2c/' or `/var/lib/texmf/web2c/'; the -environment variable is `TEXFORMATS'. + You then have to install the resulting 'eplain.fmt' in your local +'texmf' tree or set an environment variable ('TEXFORMATS' to tell TeX +how to find it. You'll need to consult your distribution's documentation +about that. |