          LaTeX installation instructions for web2c Unix TeX
 
                            25 Sep 1995
 
 
SUMMARY
=======
 
This file contains instructions on how to install LaTeX for web2c Unix 
TeX.  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.
 
During the installation procedure, it may be easiest to set some 
environment variables.
 
The $LATEXINPUTS directory is where the LaTeX packages and classes 
are kept.  This is on the TEXINPUTS path, for example:
 
   setenv LATEXINPUTS /usr/local/lib/tex/inputs/latex

(If you're not using csh or tcsh, but a Bourne shell or one of its
successors, you would rather write:

   LATEXINPUTS=/usr/local/lib/tex/inputs/latex ; export LATEXINPUTS

The same comment applies to all following examples using setenv.)
 
The $LATEXFORMATS directory is where the LaTeX format is kept.  This 
is on the TEXFORMATS path, for example:
 
   setenv LATEXFORMATS /usr/local/lib/tex/formats
 
The $LATEXBIN directory is where the LaTeX binary is kept.  This is 
on the PATH, for example:
 
   setenv LATEXBIN /usr/local/bin
 
The $LATEXDIST directory is where the LaTeX distribution is kept.
This is normally NOT on the TEXINPUTS path, for example:

   setenv LATEXDIST /usr/local/lib/tex/latex/src

The $INDEXSTYLE directory is where the makeindex program looks for
its style files, for example:

   setenv INDEXSTYLE /usr/local/lib/texmf/makeindex

 
SAVING ANY OLD VERSION OF LATEX
===============================
 
If you have a copy of LaTeX 2.09, you may wish to save it before 
installing LaTeX2e.  
 
To begin with, you should save the LaTeX format.
 
   cd $LATEXFORMATS
   mv latex.fmt latex209.fmt
   
Then you should save the LaTeX inputs.  This will depend on whether 
your LaTeX inputs are kept in the same directory as all the other 
inputs.  If they are, then:
 
   cd $LATEXINPUTS
   mkdir ../latex209
   cp *.sty ../latex209
 
If they are not, and are kept in a separate directory, then:
 
   cd $LATEXINPUTS
   mkdir ../latex209
   cp * ../latex209
 
Finally, you can create a shell script to run the old latex, for 
example:
 
   #!/bin/sh
   TEXINPUTS=${LATEX209INPUTS:- \
      .:/usr/local/lib/tex/inputs/latex209:$TEXINPUTS}
   export TEXINPUTS
   virtex \&latex209 $*
 
 
UNPACKING THE DISTRIBUTION
==========================
 
To unpack the LaTeX distribution, you should:
 
   cd $LATEXDIST
   initex unpack.ins
   
This may take 5 or 10 minutes to unpack.
 
 
CREATING THE LATEX FORMAT
=========================
 
To create the LaTeX format, you should:
 
   initex latex.ltx
   
This will create a file latex.fmt.  You should install this with:
 
   mv latex.fmt $LATEXFORMATS
   
If you had a latex binary before, it will now pick up the new 
format.  Otherwise, you should say:
 
   cd $LATEXBIN
   ln virtex latex   
 
 
PUTTING THE FILES WHERE LATEX CAN READ THEM
===========================================
 
To install the LaTeX files, you should:
 
   cd $LATEXDIST
   mv latexbug.tex testpage.tex lablst.tex idx.tex nfssfont.tex \
      small2e.tex sample2e.tex docstrip.tex \
      *.cls *.clo *.sty *.fd *.def *.cfg \
      $LATEXINPUTS
   mv *.ist $INDEXSTYLE
      
You have now installed LaTeX!
 
 
CHECKING THAT THE INSTALLATION WORKED
=====================================
 
To check that the installation worked, you should:
 
   cd $LATEXDIST
   latex ltxcheck
   
This will perform a number of tests, which should all report `OK'.
 
 
--- Copyright 1995 the LaTeX3 project. ---
---       All rights reserved.         ---
