READ.ME file for AMS-LaTeX, 9-Dec-1994

This is a preliminary release of AMS-LaTeX updated for compatibility
with current LaTeX. It's designated as "beta" because (a) more testing
is needed, (b) the documentation needs work, and (c) a couple of
preliminary decisions about command usage and package options will
need to be changed in the final release. In addition, the packages
amsfonts, amssymb, eufrak, eucal, euscript are going to be moved from
the AMS-LaTeX distribution to the AMSFonts distribution, since they are
relevant only for someone who has a copy of the AMSFonts distrib on
their system.

Support for `compatibility mode'---that is, reproducing exactly the same
results as version 1.1 for existing documents that use \documentstyle
instead of \documentclass---is incomplete. Most compatibility-mode
documents should run through without error messages at least, but
there will be some observable differences in the results.

Some AMS-LaTeX 1.1 users whose TeX implementation has relatively limited
memory capacities may not be able to use AMS-LaTeX 1.2. For example,
there is an upper limit of 3500 control sequence names (hash size) in
emTeX's tex286. This was marginally sufficient for LaTeX 2.09 +
AMS-LaTeX 1.1, but is not enough for current LaTeX + AMS-LaTeX 1.2.

INSTALLATION

To use version 1.2 of AMS-LaTeX it is necessary for you to have a recent
version of LaTeX (June 1994 or later, "LaTeX2e"). If you're not sure
about the version, look at the startup message that is printed on screen
and in the TeX log when you run LaTeX. It should mention the LaTeX
version number and date somewhere in the first ten lines. If your
version of LaTeX is older than June 1994, we suggest getting the latest
version from the Comprehensive TeX Archive Network (CTAN), directory
tex-archive/macros/latex, ftp addresses ftp.shsu.edu (US), ftp.dante.de
(Germany), or ftp.tex.ac.uk (UK). If ftp file transfer is not an option
for you, contact the source from which you originally obtained LaTeX.
If you are unable for some reason to upgrade from version 2.09 of LaTeX,
you could try using version 1.1 of AMS-LaTeX, which is available in a
separate area (on e-math.ams.org: /ams/amsltx11).

Files in the AMS-LaTeX set:

  amslatex.ins    main installation file
  amslatex.chg    synopsis of changes from version 1.1
  amslatex.bug    description of reported bugs (since Oct 11 1994)
  amsldoc.tex     users' guide

  testart.tex     test file for ams article style
  testbook.tex    test file for ams book style
  preface.tex     test file - input by testbook
  chap1.tex       test file - input by testbook
  app.tex         test file - input by testbook
  biblio.tex      test file - input by testbook
  index.tex       test file - input by testbook
  testmath.tex    test file for math environments
  subeqn.tex      test file for `subequations' environment

  amsbsy.dtx      for \boldsymbol and \pmb
  amscd.dtx       for commutative diagrams
  amsgen.dtx      auxiliary file
  amsintsm.dtx    new versions of \int and \sum
  amstex.dtx      equations and other math
  amstext.dtx     \text command
  amsxtra.dtx     misc rarely used commands
  amscls.dtx      source file for amsart/amsbook document classes
  amsldoc.dtx     document class for printing AMS .dtx files
  amsthm.dtx      provides \theoremstyle, \newtheorem*
  romref.dtx      makes \ref always produce roman/upright numbers

  amsfonts.ins    an installation file to create .fd files
                   for users who have the AMS fonts set
  psamsfnt.ins    alternative version of amsfonts.ins, for Y&Y
                   PostScript version of the AMS fonts set
  amsfonts.dtx    for using AMS fonts msam, msbm, eufm
  amssymb.dtx     for extra symbols in msam, msbm fonts
  euscript.dtx    for using AMS fonts eusm, eusb
  eufrak.dtx      for using AMS fonts eufm, eufb
  amsfonts.fdd    source for font-definition files

There are two `areas' (directories or folders) on your system that are
involved in installing AMS-LaTeX: an AMS-LaTeX source files area, and
a LaTeX input files area. The basic procedure is to put all the files
in the AMS-LaTeX distribution into the AMS-LaTeX source files area,
then run LaTeX on an installation file \fn{amslatex.ins}, and then move
the resulting files to the LaTeX input area.

The precise names of these two areas can vary widely from system to
system; however, here are some typical area names:

        AMS-LaTeX source files area           LaTeX input area
========================================================================
DOS     c:\emtex\latex\packages\amslatex      c:\emtex\latex\inputs
Unix    /tex/latex/packages/amslatex          /tex/latex/inputs
Mac     OzTeX:latex:packages:amslatex         OzTeX:latex:inputs
VMS     tex_disk:[latex.packages.amslatex]    tex_disk:[latex.inputs]


In the following suggested installation process, we use PC/DOS directory
and file name conventions for concreteness; for other systems, it should
be obvious how to adapt the names.

The destination directory for the above files should be

  xxx\latex\packages\amslatex

where xxx depends on the type of computer system and TeX directory
structure the user has. Let's say it is emTeX, then "xxx" will normally
be "c:\emtex".

So you would put the above files into the directory

  c:\emtex\latex\packages\amslatex

Next run LaTeX on the installation file amslatex.ins. This will create the
stripped files amstex.sty, amssymb.sty, amsart.cls, etc. that are
actually used for processing documents. All these files should then be
moved to an input directory, e.g.

  c:\emtex\latex\inputs

and this directory should be added to your TeX search path if necessary.

To test installation, try printing the test file subeqn.tex. For more
comprehensive information about using AMS-LaTeX, print the AMS-LaTeX
user's guide (amsldoc.tex).

INSTALLING FONT-DEFINITION FILES

If you have the AMSFonts set of extra math fonts, you will probably want
to run LaTeX on the installation file amsfonts.ins (or psamsfnt.ins,
see below). This will produce some .fd files and .sty files, which
should also go into your LaTeX inputs area.

If you have the PostScript version of the AMSFonts set (from Y&Y or Blue
Sky Research) you should use the alternative installation file
psamsfnt.ins, which produces .fd files adapted to the PostScript
version. Use of the PostScript-adapted font-definition files in your
documents will then require the `psamsfonts' option of the amsfonts or
amstex package, or of the AMS documentclasses (see the AMS-LaTeX users'
guide for details).

ACKNOWLEDGMENTS

Many thanks to David M. Jones for contributing the changes needed in the
amstex package to support `flush-left equations' (the fleqn option).
