install.txt for amsmath 2.0 [1999/12/17]

If you have a relatively up-do-date TeX system with a texmf directory
named something like /usr/local/share/texmf or c:\sw\texmf, installing
according to the instructions in section I below is the easiest method.
This will place the files in your texmf tree as indicated in the file
manifest.txt. Some suggestions for Textures or OzTeX are given in
Section III. For older TeX systems there is too much variation to make
simple instructions possible, but we may be able to render some
assistance if you contact us through one of the technical support
addresses given below.

The first step is to identify the ROOT directory of your texmf area for
installation:

  If your texmf directory      
  is named:                    Then ROOT is:
  -----------------------      ---------------------------
  /usr/local/share/texmf       /usr/local/share

  c:\sw\texmf                  c:\sw

In the following instructions, wherever you see ROOT substitute the
directory prefix that is used on your system, and substitute \ or :
for / if appropriate.

If this terminology doesn't make sense to you, seek assistance from
a friend or colleague, or from the company that you bought your TeX
system from, or contact us at

  tech-support@ams.org
  800-321-4AMS (321-4267) (USA/Canada)
  401-455-4080
  
========================================================================
I. Installing the easy way.

1. Download the following archive file:

   ftp://ftp.ams.org/pub/tex/amsmath2.tgz

There are also .tar.Z and .zip files for those who prefer those formats.

2. View the following files to assess the effects of the upgrade on your
system:

  00readme.txt
  install.txt (this file)
  diffs-m.txt

3. Remove the old version of AMS-LaTeX or move it out of the main LaTeX
search path. For example:

   Move ROOT/texmf/tex/latex/amslatex
     to ROOT/texmf/source/latex/amsltx12/inputs

4. Extract files using the texmf root directory as the "Extract to"
target. [If it is important for you to conserve disk space, see the
remarks in step 5.] Some typical examples:

WinZip: Click on "Extract" and then in the "Extract to" box, enter
        c:\sw (or whatever ROOT is on your system)

gzip:   gzip -dc amsmath2.tgz | (cd ROOT; tar xvf -)

unzip:  unzip -d ROOT amsmath2.zip

To check the end result, you should find that you now have amsmath.sty
in the following location

  ROOT/texmf/tex/latex/amsmath/amsmath.sty

If you have a teTeX system you may need to rerun texhash [mktexlsr].

5. A few files will appear in both the texmf/source area and the
texmf/doc area. This is because the source form and the in-use form are
identical. As distributed, the files in the texmf/source/latex/amsmath
area comprise a complete copy of the distribution from which all the
other files can be regenerated if need be. If you need to conserve disk
space, you could delete the files in the texmf/source area since they
are not needed for normal use of the amsmath package. Alternatively, you
could in step 4 selectively unpack only the subdirectories texmf/doc and
texmf/tex. Or you could elect to make use of soft link capabilities if
your system has them.

========================================================================
II. Installing the not-so-easy way.

In the following instructions replace / by \ or : if applicable for your
operating system.

Make the following directories, if not already present:

  ROOT/texmf/source/latex/ams
  ROOT/texmf/tex/latex/amsmath
  ROOT/texmf/doc/amsmath

Move the following directory, if present:

---move ROOT/texmf/tex/latex/amslatex
     to ROOT/texmf/source/tex/latex/amsltx12/inputs

Get a zip archive from CTAN (if you don't know what CTAN is, see
http://www.ams.org/tex/public-domain-tex.html#ctan):

---Download math.zip file from
   CTAN:tex-archive/macros/latex/required/amslatex to
   ROOT/texmf/source/latex/ams [choose .tgz or .tar.Z if you prefer and
   modify the following instructions in the obvious way]
   
---[optional] unzip (this gives you unpacked copies of the .dtx files in
   the `source' area, for future reference) 

Create a temporary directory and generate documentation files:

---make directory /tmp/amsmath
---unzip -d /tmp/amsmath math.zip
---cd /tmp/amsmath
---Run latex on the file ams-m1.ins to produce .cls and .sty files
---Run latex on *.tex
---[optional] Run LaTeX on *.dtx (technical documentation)
---move *.dvi, *.tex, *.faq to ROOT/texmf/doc/amsmath
---[optional] move *.dtx to ROOT/texmf/doc/amsmath
---[optional] convert .dvi to .ps or .pdf
---move *.sty and *.cls to ROOT/texmf/tex/latex/amsmath
---delete /tmp/amsmath

If you have a teTeX system you may need to rerun texhash [mktexlsr].

========================================================================
III. Macintosh (Textures or OzTeX) installation.

1. Download a .zip archive from the AMS:

   ftp://ftp.ams.org/pub/tex/amsmath2.zip

2. Use StuffIt or similar application to view the following files inside
the archive and assess the effects of the upgrade on your system:

  texmf/source/latex/amsmath/00readme.txt
  texmf/source/latex/amsmath/install.txt (this file)
  texmf/source/latex/amsmath/diffs-c.txt

3. Determine the location of your LaTeX inputs folder and LaTeX
documentation folder. Typical values are:

  OzTeX:TeX:Inputs:LaTeX:
  OzTeX:TeX:Docs:LaTeX:

or

  Textures:TeX inputs:*LaTeX:           (where * is a bullet character)
  Textures:LaTeX support:LaTeX Documentation:    

4. [Optional] Move existing files from AMS-LaTeX 1.2 to another folder
for fallback purposes. This would include the following files in your
LaTeX inputs folder:

  amsbsy.sty 
  amscd.sty 
  amsdtx.cls      
  amsgen.sty     
  amsldoc.cls   
  amsmath.sty
  amsopn.sty 
  amstex.sty 
  amstext.sty
  amsxtra.sty

The 1.2 release of AMS-LaTeX will remain available from the AMS for
reference.

5. Find the texmf/tex/latex/amsmath folder in the zip archive and
extract its contents into your LaTeX inputs folder.

6. Find the texmf/doc/latex/amsmath folder in the zip archive and
extract its contents into your LaTeX documentation folder.
