
             LaTeX installation instructions for Y&YTeX v1.1

                             1994 May 23 


SUMMARY 
======= 

This file contains instructions for installing LaTeX2e for Y&YTeX v1.1 
(either from DVIWindo's `TeX Menu' or from the DOS prompt).

Before reading this file, you should read `install.txt', which explains 
how the LaTeX2e installation works. 

This file describes: 

 * How to save any old version of LaTeX. 

 * How to configure LaTeX. 

 * How to unpack the LaTeX distribution. 

 * How to create the LaTeX format. 

 * How to install the LaTeX files. 

 * How to check the LaTeX installation. 

 * What to do if you have any problems. 

SAVING ANY OLD VERSION OF LATEX 
=============================== 

The installation instructions below for LaTeX2e are designed to *preserve*
your existing LaTeX 2.09 files.  That way you can drop back to LaTeX 2.09
in the unlikely event that some problem should crop up.  After a while,
when you are certain that everything is working to your satisfaction, 
you can delete the old files to free up some disk space (see below).

The format file for LaTeX 2.09 is called `lplain.fmt' in the `fmt'
sub-directory of your `y&ytex' directory --- typically `c:\y&ytex\fmt' 
(or wherever the environment variable TEXFORMATS points to).  This format 
file will not be disturbed by the installation of LaTeX2e since the new 
format file is called `latex.fmt'.

The style files for LaTeX 2.09 are in the `latex' sub-directory of your
`y&ytex' directory --- typically `c:\y&ytex\latex' (one of the directories
that the environment variable TEXINPUTS points to).  This directory will 
not be disturbed by the installation of LaTeX2e --- the new files go in the 
`latex2e' sub-directory instead.

Do the following if you want to be able to switch easily between LaTeX 2.09
and LaTeX2e.  Set the TEXINPUTS environment variable so the directory
with the LaTeX 2.09 files is listed *before* the directory with the new
LaTeX2e files.  For example:

        set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e

Then you can call LaTeX2.09 with the old `latex.bat' batch file (which
uses `&lplain' on the Y&YTeX command line), and you can call LaTeX2e
using  the new `latex2e.bat' batch file (which uses `&latex' on the Y&YTeX
command line).  DVIWindo's `TeX Menu' will list *both* the old `LaTeX'
(i.e. LaTeX 2.09) and the new `LaTeX2e' formats. 

Once you decide that you no longer need LaTeX 2.09, you can save a
bit of disk space.  Do the following:

(i)   delete `lplain.*' from the `fmt' sub-directory of the `y&ytex' directory;
(ii)  delete  all files in the `latex' sub-directory of the `y&ytex' directory;
(iii) remove the `LaTeX' entry in DVIWindo's `TeX Menu';
(iv)  delete the `latex.bat' batch file from your batch file directory.

CONFIGURING LATEX 
================= 

First of all, to run the installation procedure you need to set the
TEXINPUTS environment variable to include the directory with the LaTeX2e
source files.  If you use the recommended directory you could just type:

        set TEXINPUTS=c:\latex2e

After running the installation procedure you need to add the `latex2e'
subdirectory of the `y&ytex' directory to the directory list in the
TEXINPUTS environment variable.  If you want to be able to switch easily
between the old LaTeX 2.09 and LaTeX2e, then add the `latex2e' directory
*after* the `latex' directory.  For example:

        set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e

If you will *only* be using the new LaTeX2e, you can, of course, omit the
reference to the `latex' subdirectory.  

Typically you insert code to set the environment variables in your
`autoexec.bat' file so that it always takes effect when you reboot.  
To avoid having to reboot before using LaTeX2e, *also* execute the above
environment setting code from the command line in DOS (but *not* in a DOS
box in Windows).

You can run LaTeX2e from DVIWindo's `TeX Menu' --- by selecting `LaTeX 2e'
--- or direct from DOS.  In the latter case you can just use the existing
`tex.bat' batch file:

        tex &latex <source-file>

Or you may find it convenient to create a new `latex2e.bat' batch file.
To do this, simply copy `latex.bat', and replace `&lplain' with `&latex'.

While LaTeX2e requires more TeX memory than LaTeX 2.09, there is no need
to do anything, since Y&YTeX's dynamic memory allocation automatically
only uses as much memory as is needed.

UNPACKING THE DISTRIBUTION 
========================== 

Create a directory on your hard disk for the LaTeX2e source files 
(Don't mix them up with other files, since you may want to delete them
again after installation in order to conserve disk space).  For example:

        mkdir c:\latex2e

Run the installation batch file on the LaTeX2e distribution diskette
to unzip the files into this directory --- or get the latest version
of the distribution off your nearest CTAN site by anonymous FTP.

Create an empty temporary directory (on a drive with at least a Megabyte of
free space).  Make that the current directory.  Next, set the environment
variable TEXINPUTS to include the directory with the new LaTeX2e source
files.  For example:

        set TEXINPUTS=c:\latex2e

You will also need to supply a file with hyphenation patterns.  You can
do this either by copying the standard `hyphen.tex' file for English ---
or a hyphenation pattern file for another language --- to the current
directory, or by adding a directory (s.a. c:\y&ytex\latex) which contains
`hyphen.tex' to the list of directories in the TEXINPUTS environment variable:

        set TEXINPUTS=c:\latex2e;c:\y&ytex\latex

Also make sure the environment variable TEXFORMATS points to the
`fmt' sub-directory of your `y&ytex' directory.  For example:

        set TEXFORMATS=c:\y&ytex\fmt

You can create new TeX formats (i) directly from the `TeX Menu' in DVIWindo,
(ii) using the `initex.bat' batch file, or (iii) `manually' from the DOS
command line.  If you work from the `TeX Menu' or use the `initex.bat' batch
file, then most of the details of LaTeX2e format creation are automatically
taken care off.  In fact, the two steps "Unpacking the Distribution" and
"Creating the LaTeX format" are then combined into *one* operation, and you
need not deal with all the details.

For example, if you run ini-TeX from the `TeX menu' in DVIWindo, just
enter `LaTeX 2e' for `Format Name' and enter `latex2e' for `Format Source
File.'  The `initex.bat' batch file which is called will take care of
running ini-TeX *twice* (once on `unpack.ins', then on `latex.ltx').
It will also copy the finished `format' file to the `fmt' sub-directory
of your `y&ytex' directory, and create a `LaTeX 2e' entry in the `TeX Menu'

*       And that is all there is to it!  

(Unless the names of the LaTeX2e files have changed again --- 
see `Problem' section at end)

If you instead want to unpack the files `manually' from the DOS prompt,
run ini-TeX on the file `unpack.ins'.  Using the `tex.bat' batch file:

                tex -i unpack.ins

(or call Y&YTeX directly:  c:\y&ytex\y&ytex -i unpack.ins).

This may take some time --- on an old 486 it may take as long as 4--5 minutes.
You can speed the process up somewhat by choosing a temporary directory on a
RAM drive rather than a hard disk (and avoid reading the source files
directly from a diskette instead of copying them to a hard disk first).


CREATING THE LATEX FORMAT 
========================= 

If you called ini TeX form the `TeX Menu' in DVIWindo, then the format
has already been created and saved, so nothing else need be done!  

Read on if you instead unpacked the files `manually'. 

Running ini-TeX on the file `unpack.ins' creates a large number of files,
including `latex.ltx'.  You also need to supply `hyphen.tex' with
hyphenation patterns (see previous section).  To create the new LaTeX2e
format, now run ini-TeX on `latex.ltx'.  You can use the batch file
`tex.bat' again:

        tex -i latex.ltx

(or call Y&YTeX directly:  c:\y&ytex\y&ytex -i latex.ltx).

The resulting format file, `latex.fmt' should be copied to the
`fmt' sub-directory of your `y&ytex' directory.  For example,

        copy latex.fmt c:\y&ytex\fmt

You may also wish to copy `latex.log' to the `fmt' directory.


PUTTING THE FILES WHERE LATEX CAN READ THEM 
=========================================== 

You also need to move the files created when ini-TeX ran on `undump.ins'
to a permanent home where TeX can find them.  Create a `latex2e'
sub-directory of your `y&ytex' directory.  For example:

        mkdir c:\y&ytex\latex2e

Then copy all of the files from the temporary directory to that new
directory. For example:

        copy *.* c:\y&ytex\latex2e

Then add this directory to the list of directories in TEXINPUTS. For example:

        set TEXINPUTS=c:\tex;c:\letters;c:\y&ytex\latex;c:\y&ytex\latex2e

You have now installed LaTeX 2e! 

CHECKING THAT THE INSTALLATION WORKED 
===================================== 

It is important to check that the installation worked.  To do this 
run the new LaTeX2e on the file `ltxcheck.tex'.  You can do this from
DVIWindo's `TeX Menu' or from the DOS command line.  

In the `TeX Menu' simply select `LaTeX 2e' and in the `Open File' dialog
navigate to `c:\y&ytex\latex2e\ltxcheck.tex' (or wherever you placed your
LaTeX2e source files).  Or, run Y&YTeX directly using `tex.bat':

        tex &latex ltxcheck

It is highly recommended that you run this test before going on!
The test file will check some basic features of your TeX setup and 
either say they are OK or complain and say they are BAD.

After this, you may also wish to process `features.tex' and print the
result, unless you have already done so.

PROBLEMS 
======== 

The names of the basic files of LaTeX2e have changed since it first
appeared in alpha release.  As a result you may have a Y&Y TeX Package
that is set up for some older set of file names.  Check in particular
that the batch file `initex.bat' refers to `unpack.ins' and `latex.ltx'
in the two calls to ini-TeX.  You may very well have to replace the
old file names `unpack2e.ins' and `latex2e.ltx' with the new `unpack.ins' 
and `latex.ltx'. 

If you have other problems with the LaTeX installation, see the 
`PROBLEMS' section in `install.txt'. 

If `ltxcheck' produces a `BAD' message, you will typically be able to
figure out from the message what is wrong.  For example, you may not
have the environment variable TEXINPUTS set up to include the new
LaTeX2e files.  If it is not obvious what caused the `BAD' message,
then please consult the section on `ltxcheck' in `texpert.txt'. 

If you have any problems not resolved by the above, please contact Y&Y at:

71172.524@compuserve.com        (email)
(508) 371-2004                  (fax)
(508) 371-3286                  (voice)

Y&Y, Inc.
45 Walden Street                (snail mail)
Concord, MA, 01742, USA

--- Copyright 1994 (C) Y&Y, Inc. and the LaTeX3 project --- 
---                 All rights reserved.                --- 





