           LaTeX installation instructions for emTeX
    
                        11 June 1995
 
 
SUMMARY
=======
 
This file contains instructions on how to install LaTeX for emTeX on
DOS; users of emTeX on OS/2 will need to make the standard small
changes, such as `.cmd' instead of `.bat'.

Before reading this file, you should read install.txt, which will
explain how the LaTeX installation works.
 
This file describes:
 
 * How to save any old version of LaTeX.
 
 * How to unpack the LaTeX distribution.
 
 * How to create the LaTeX format.
 
 * How to install the LaTeX files.
 
These instructions assume that you are using the standard directory set
up supplied by the emTeX distribution.  We hope that, if your system's 
set up differs from this then you will be sufficiently familiar with
your system to make the necessary amendments to these instructions.


SAVING ANY OLD VERSION OF LATEX
===============================
 
If you have a copy of LaTeX 2.09, you may wish to save it before 
installing the new LaTeX.  
 
You should make a subdirectory called latex209 in the emtex directory.
Then copy any files called *.sty from the TeX inputs directory
(normally emtex\texinput) into this latex209 subdirectory.  You should
also rename the LaTeX format file which you use for LaTeX 2.09,
usually lplain.fmt, to latex209.fmt.

You should then create a batch file latex209.bat, which temporarily
resets the TEXINPUT environment variable to a path which includes the
latex209 subdirectory before the TeX inputs directory, and then calls
TeX with the file latex209.fmt as the format file.  Check that this
batch file works before proceeding.

 
UNPACKING THE DISTRIBUTION
==========================
 
To unpack the LaTeX distribution, you should change to the directory
reserved for the installation and run iniTeX on the file unpack.ins.
To run iniTeX you use the  option /i so this is typically done by
typing:

   tex /i unpack.ins
   
 
CREATING THE LATEX FORMAT
=========================
 
To create the LaTeX format, you should run iniTeX on the file
latex.ltx.  This will create a file latex.fmt.

You should copy this to the directory where TeX looks for its format
files, normally the texfmts or btexfmts subdirectory of emtex.  Make
sure that you put it in the correct directory: the one that is used by
the version of the TeX program you are using.
 
 
PUTTING THE FILES WHERE LATEX CAN READ THEM
===========================================
 
You should move the following files to the TeX inputs directory
(usually emtex\texinput):
 
   latexbug.tex  testpage.tex  docstrip.tex
   *.cls  *.clo  *.sty  *.fd  *.def  *.cfg

If you use the MakeIndex program (called makeindx.exe) then you should
move the *.ist files into the MakeIndex inputs directory (normally
emtex\makeindx).
 

CHANGING THE BATCH FILE
=======================

You should edit the file latex.bat (if you do not have one then you
may wish to create it) so that it calls TeX with the file latex.fmt
as the format file.


CHECKING THAT THE INSTALLATION WORKED
=====================================
 
You should now run LaTeX on ltxcheck.tex.  This should produce a
number of `OK' messages.  If it produces any warnings, please consult
the `Problems' section of the file install.txt.


MEMORY PROBLEMS
===============

If you have an old version of emTeX, or you are using a PC with a CPU
less powerful than an 80386, then you will need to increase that part
of the memory known as `string characters' or as `pool size'.

This should be set to its maximum value by using the option:

  /mp:65500

either on the command line or via the EMTEXOPT environment variable.

You will probably be able to compensate for this increased
requirement by reducing the `font info' memory using the
option `/mf:'.

When using several packages or when processing complex documents,
especially if they contain lots of cross-references, citations, etc.,
you may run out of the memory known as `multiletter control sequences'
or as `hash table'.  Unfortunately, the only cure for this is to get a
newer version of emTeX.

--- Copyright 1995 the LaTeX3 project ---
---       All rights reserved.        ---

