summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/eplain/INSTALL
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-12-08 00:25:19 +0000
committerKarl Berry <karl@freefriends.org>2006-12-08 00:25:19 +0000
commit7ff51640e2fd3e968488d312879dee70458f2926 (patch)
tree6b9ede61598bd09a713892640d2d41da6913e509 /Master/texmf-dist/doc/eplain/INSTALL
parent8291b74ec6f858e3536a5919b74386a7df1dcc24 (diff)
eplain 3.1 (5dec06)
git-svn-id: svn://tug.org/texlive/trunk@2630 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/eplain/INSTALL')
-rw-r--r--Master/texmf-dist/doc/eplain/INSTALL46
1 files changed, 46 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/eplain/INSTALL b/Master/texmf-dist/doc/eplain/INSTALL
new file mode 100644
index 00000000000..dcd705281b6
--- /dev/null
+++ b/Master/texmf-dist/doc/eplain/INSTALL
@@ -0,0 +1,46 @@
+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
+ 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 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'.
+