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).