LaTeX2e installation instructions
for Textures users
 
Blue Sky Research, July 1, 1994


SUMMARY
 
This file contains specific details on how to install LaTeX2e for
Textures.  You should also read the general installation instructions
found in 'install.txt', which will explain the overall procedures.

This file describes:
 
 * How to save the previous version of LaTeX 2.09;
 
 * How to unpack the LaTeX2e distribution;
 
 * How to create the LaTeX2e format;
 
 * How to install the LaTeX2e files.



FOR THOSE WHO ARE NERVOUS...!

LaTeX2e installs easily with Textures, and appropriate installation
instructions follow.  Before you begin, however, here are some things to
consider.

Blue Sky Research will be integrating LaTeX2e into our Classic Textures
package, version 1.7, to be released in early fall.  At that time,
LaTeX2e will become a regular part of our product line, and the
precompiled format and necessary files will be available from Blue Sky,
complete with technical support.

Although most features of LaTeX2e can be used with any version of
Textures, some advanced capabilities of LaTeX2e require the virtual font
facilities of Textures 1.6; others may be best handled by defining new
font maps, which is beyond the ability of many users.  We expect to have
prepared solutions for these issues by the time we release Textures 1.7.
Although these concerns are not relevant to most users, the faint of
heart (and those who like the backup of a live support staff) should
consider waiting for our new release to switch to LaTeX2e.

We are not prepared to provide customer support on the use of LaTeX2e
until the release of the integrated version.  However, we hope these
instructions will provide the basics for successful operation of LaTeX2e
until then.

 
 
SAVING YOUR 2.09 VERSION OF LATEX

LaTeX2e can process LaTeX 2.09 documents in most cases, so the
recommended practice is to convert entirely to LaTeX2e rather than
attempting to use both systems simultaneously.  However, for your own
security, we recommend saving your existing LaTeX format and style files
so that you can revert to LaTeX 2.09 if necessary.

This is easy!  Simply change the name of your existing LaTeX format file
from 'LaTeX' to 'LaTeX 2.09' before creating the new LaTeX format file.
This format can stay in the 'TeX formats' folder, or you can set it
aside.  Also, make a *complete* copy of your current 'TeX inputs' folder
and set it aside under, say, the name 'LaTeX 2.09 inputs'.  (Some of the
files in each version of LaTeX have the same names, but different
contents, so it's not possible to put the files for both versions into
one 'TeX inputs' folder.)  You may use any names you choose for the
set-aside folders; also, the capitalization of names is not important.

If you need to switch back to the 2.09 version of LaTeX, you will need
first to quit Textures and then to swap 'TeX inputs' folders.  You do
this simply by renaming the folders, i.e., rename 'TeX inputs' to
'LaTeX2e inputs', and then rename 'LaTeX 2.09 inputs' back to 'TeX
inputs'.  Each time you start Textures, the folder named 'TeX inputs'
*at that time* will be used for style files and other inputs. If you try
to run either version of LaTeX with the wrong 'TeX inputs' folder, no
harm will be done, but you will be swimming in error messages!

After switching the 'TeX inputs' folder, restart Textures, and choose
the 'LaTeX 2.09' format for each document you need to typeset with the
older version.

To switch back to LaTeX2e, quit Textures, and again rename the 'TeX
inputs' folder(s).


CONFIGURING TEXTURES FOR LATEX2E
 
LaTeX2e uses more memory than LaTeX 2.09, so you may need to increase
the Textures memory partition; this is normally set to 2400K, and can be
increased as necessary from the Finder.  'Get Info' of the Textures
application, and enter the desired partition size, say 3000K.
   

UNPACKING THE LATEX2E DISTRIBUTION

After setting aside your older LaTeX 2.09 format and 'TeX inputs'
folder, download all of the LaTeX2e files from the CTAN archive into a
folder called LaTeX2e.
 
Open 'unpack.ins' in Textures.  Choose the VirTeX format and Typeset.
This will start the automated unpacking process.  Be patient, this can
take some time: anywhere from 15 minutes to 3 hours depending on your
Mac.

NOTE: The program will likely provide prompts telling you it has found
files by the same name on the system and asking permission to overwrite.
A `Yes' response WILL NOT overwrite existing files in other folders, but
will create new ones in the LaTeX2e folder, so go ahead.
 
Using Textures, create a new file called texsys.cfg in the LaTeX2e
folder just containing the line:

\let\@currdir=\@empty

This tells LaTeX that textures does not have a notion of current
directory in the sense of some UNIX or other TeX implementations.



CREATING THE LATEX2E FORMAT

 
Open 'latex.ltx' in Textures.  Again, select the VirTeX format; then,
turn off Flash Mode and select `Typeset'.  Save the resulting format as
`LaTeX'.  Move the new format from the LaTeX2e folder to your 'TeX
formats' folder and restart Textures.  The new LaTeX format will be
visible under the Typeset Menu; if the older LaTeX 2.09 format is still
in the 'TeX formats' folder, it will also be visible with that name.
 

PUTTING THE FILES WHERE LATEX2E CAN READ THEM
 
After running the install procedure, move the following files from the
LaTeX2e folder into the (new) 'TeX inputs' folder:

 latexbug.tex
 testpage.tex
 lablst.tex
 idx.tex
 nfssfont.tex 
 small2e.tex
 sample2e.tex
 docstrip.tex
 *.cls
 *.clo
 *.sty
 *.fd
 *.def
 *.cfg

The remaining files can remain in your LaTeX2e folder, which is probably
best stored in your Textures folder.
       
 
TESTING THE LATEX2E INSTALLATION
 
Open 'ltxcheck.tex' in Textures.  Select the LaTeX format, and Typeset.

You may see the following warning in the TeX Log window, this means that
the texsys.cfg file described above was not used. You may either
recreate a suitable texsys.cfg, and remake the format (you do not need
to unpack the files again) or you can simply ignore this warning.

article.cls in current directory!
! This file should not be run in a `system directory'.
\@tempa ...a `system directory'}
                                
l.145 ... `system directory'}}{}

If the document finishes typesetting, all is well.  If there is an
installation problem, the TeX Log will produce "BAD" warnings, and
refuse to continue.
Read the log for hints, fix the problem, and try again.


REMOVING UNNECESSARY FILES

After LaTeX has been successfully installed, you might want to delete
some non-essential files (after making backups) to free up space on your
hard disk.  From the LaTeX2e folder, you may delete all files ending in:

                .ins   .drv   .dtx    .fdd

Note that the dtx files are documentation, for instance, documentation
on LaTeX's new class and package commands may be produced by processing
the file ltclass.dtx through LaTeX. However you do not need these files
on your hard disk to use LaTeX.


POTENTIAL PROBLEMS
 
FONTS:

LaTeX2e in some cases calls for some fonts which are not part of the
Computer Modern font set, e.g., CMSY9 and others. These fonts
are available in our AMS PostScript font package.

LaTeX2e will sometimes generate many, many messages about fonts in the
TeX Log.  These are diagnostic messages to aid the LaTeX2e developers,
and will not interfere with successful typesetting, Closing the TeX Log
window will speed up typesetting and allow you to ignore these
non-essential messages. (The TeX Log window will automatically open if
an error occurs.)


INSTALLATION PROBLEMS:

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

--- Copyright 1994 Blue Sky Research and the LaTeX3 project ---
---              All rights reserved.                ---