summaryrefslogtreecommitdiff
path: root/macros/eplain/doc/INSTALL
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-10-07 03:03:15 +0000
committerNorbert Preining <norbert@preining.info>2022-10-07 03:03:15 +0000
commitbbbfa0a90645d4da46b1492f6513b28a01eb78da (patch)
treedcbf82e9f2bd50ac7596114690ad31ca7a6dbf8c /macros/eplain/doc/INSTALL
parent678708e90ffe138885ed8c06b6780d491b80fae5 (diff)
CTAN sync 202210070303
Diffstat (limited to 'macros/eplain/doc/INSTALL')
-rw-r--r--macros/eplain/doc/INSTALL58
1 files changed, 25 insertions, 33 deletions
diff --git a/macros/eplain/doc/INSTALL b/macros/eplain/doc/INSTALL
index dcd705281b..8c726e7c0e 100644
--- a/macros/eplain/doc/INSTALL
+++ b/macros/eplain/doc/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.