AMSFonts 2.2d README January 2002 This is a documentation file to accompany the AMSFonts 2.2d distribution. If you have obtained a bundled AMSFonts collection, the bundle will unpack into the standard TeX Directory Structure (TDS) tree; see the installation procedures in Appendix A of the AMSFonts User's Guide, which can be viewed from the link on the web page http://www.ams.org/tex/amsfonts.html If you have obtained the files individually from the FTP site, follow the instructions below to install the files. Copy all of the files in this directory (/pub/tex/amsfonts) and the following subdirectories into the indicated directory in the TDS tree: All users: /pub/tex/amsfonts/plaintex to TEXMF/tex/plain/amsfonts/ /pub/tex/amsfonts/doc to TEXMF/source/ams/amsfonts/ /pub/tex/amsfonts/doc/latex to TEXMF/source/ams/amsfonts/ /pub/tex/amsfonts/latex to TEXMF/tex/latex/amsfonts/ /pub/tex/amsfonts/tfm to TEXMF/fonts/tfm/ams/ Users of Cyrillic text: /pub/tex/amsfonts/alt-cyr to TEXMF/fonts/source/ams/cyr-alt/ Users who wish to use .pk files provided with the distribution: appropriate subdirectories of /pub/tex/amsfonts/pk-files, depending on resolution of output device to TEXMF/fonts/pk/ams/ Users who wish to generate their own .pk files: /pub/tex/amsfonts/sources and its subdirectories to TEXMF/source/ams/amsfonts/ If your installation is not arranged in a TDS tree, see also the section below, "Installing AMSFonts 2.2 on your system", as well as the user documentation for your TeX distribution. If you are preparing to obtain the files in this distribution by ftp, please note that transmission time can be improved by getting the files in compressed format, if you have the necessary unpacking tools at your end. From a CTAN archive, you can for example request dirname.zip to get the contents of any directory in zipped form, and similarly for other common compression formats; see the CTAN help information for more details. (NOTE: subdirectories are automatically included; but in the case of the AMSFonts distribution you should be careful to avoid retrieving all the pk-files subdirectories, as they contain hundreds of files and it's highly unlikely that you will require them all.) From the AMS archive at ftp.ams.org, .tar.Z or .tar files for various common selections are available in the parent directory `ams'. To unpack these you need `tar' and `uncompress' programs. ----------------------------------------------------------------- What changes were made between AMSFonts 2.2 and AMSFonts 2.2d? No changes have been made to the fonts themselves, either to the Metafont sources, the .tfm or .pk files. The primary purpose of this upgrade is to fix bugs in the LaTeX support files and to update the User's Guide. ----------------------------------------------------------------- What changes were made between AMSFonts 2.1 and AMSFonts 2.2? The primary change is the inclusion of LaTeX support macro files as part of the AMSFonts distribution. The files in the "latex" subdirectory of this directory are compatible with LaTeX2e, the current LaTeX standard. Users of LaTeX 2.09 are strongly encouraged to upgrade to LaTeX2e, as we do not support the use of AMSFonts with LaTeX 2.09. The only significant change to the characters in the fonts was a bug fix which corrected an anomaly in the Blackboard Bold N character from the MSBM fonts. That character printed incorrectly at a few resolutions (including 600dpi); it now prints correctly at all resolutions. The metrics for AMSFonts 2.2 are unchanged from those for AMSFonts 2.1. There has also been a slight change to the file amssym.tex, and very significant changes to the User's Guide. ----------------------------------------------------------------- INSTALLING AMSFonts 2.2 ON YOUR SYSTEM 1. Installing the fonts: The files from the appropriate subdirectory of the pk-files subdirectory of this directory (/pub/tex/amsfonts/pk-files/dpi118 for 118dpi fonts, /pub/tex/amsfonts/pk-files/dpi180 for 180dpi fonts, etc.) should be copied into the directory/ies where your device drivers look for .pk files to translate .dvi files into printed or displayed output. If your TeX looks at one directory, where the magnifications and resolutions of the pk files are indicated as part of the extension of the filename, then you may copy them precisely as they are. If your TeX expects all pk files to have the extension simply `.pk' and the magnifications and resolutions are determined by the name of the subdirectory in which they appear, then you will want to copy them into subdirectories named similarly to their current extensions, and rename them all to have extension `.pk'. For example, if your TeX looks for a subdirectory named DPI300 for 300dpi pk files, then you will want to copy all of the files *.300pk into that directory and then rename them all to *.pk; also copy *.329pk into DPI329 (or whatever name your TeX uses) and then rename them all to *.pk; etc... The .tfm files from the directory /pub/tex/amsfonts/tfm should be copied into the directory on your system where your implementation of TeX looks for .tfm files. Depending on what TeX system you use, it may also be necessary to update a filename database; see the documentation for your TeX distribution. 2. Installing the auxiliary files: There are two sets of files which provide macros necessary for using AMSFonts 2.2 in TeX. One set is for Plain TeX or AMS-TeX, and one set is for LaTeX. If you use Plain TeX or AMS-TeX, then the files in /pub/tex/amsfonts/plaintex should be placed in the directory (or a directory in the path) which your implementation of TeX searches for input files. If you use LaTeX2e, then the files in /pub/tex/amsfonts/latex should be placed in that directory. (If you use LaTeX 2.09, then we strongly encourage you to upgrade your installation to LaTeX2e, as this is the current standard for LaTeX throughout the world, and we do not provide support for use of AMSFonts in LaTeX 2.09.) If you are likely to use LaTeX2e as well as Plain TeX or AMS-TeX, then install the files from both directories where your TeX will find them for input. Depending on what TeX system you use, it may also be necessary to update a filename database; see the documentation for your TeX distribution. 3. The User's Guide: You can get a copy of the User's Guide via a link on the web page http://www.ams.org/tex/amsfonts.html However, this manual is a good test of your AMSFonts installation. In order to TeX and print the User's Guide, you must first install the fonts. The `doc' subdirectory (/pub/tex/amsfonts/doc) contains five input files with names beginning with `amsfndoc'. When you have completed your installation, process the file `amsfndoc.tex' with Plain TeX (not AMS-TeX or LaTeX). It will input four other `amsfndoc' files: .def, .cyr, .ins and .fnt. The output will be a complete guide to the use of AMSFonts 2.2d. This directory also contains a file called "amsfonts.faq" in which we will place frequently asked questions about AMSFonts. The /latex subdirectory of the "doc" directory contains LaTeX .dtx files containing technical commentary on the source code for the LaTeX support files in the AMSFonts distribution. Although these .dtx files are included for reference, most users can ignore them. ----------------------------------------------------------------- USE OF THE LATEX `amsfonts' PACKAGE Version 2.2 of the LaTeX package amsfonts.sty is carefully constructed to allow it to be used for processing pre-existing documents originally written for AMS-LaTeX 1.2beta or earlier. This means that documents that loaded amsfonts.sty through statements such as the following should continue to work without change. 1. \documentstyle[amsfonts]{article} 2. \documentstyle[amstex]{article} 3. \documentstyle[amssymb]{article} 4. \documentstyle{amsart} 5. \documentclass{amsart} 6. \documentclass{article} \usepackage{amsfonts} 7. \documentclass{article} \usepackage{amsmath,amsthm} 8. \documentclass{article} \usepackage{amssymb} There is an exception, however, for the variants 6 and 7: If your document was written for AMS-LaTeX 1.2beta, some time in 1994, AND if it uses any of the symbols \square \Box \lozenge \Diamond \vartriangleright \rhd \vartriangleleft \lhd \trianglerighteq \unrhd \trianglelefteq \unlhd \rightsquigarrow \leadsto \Join then you may find that those symbol commands now produce `Undefined control sequence' errors. The easiest way to fix this is to load the amssymb package, i.e. change variants 6 and 7 to 6a. \documentclass{article} \usepackage{amssymb} 7a. \documentclass{article} \usepackage{amssymb,amsmath,amsthm} For symbols \Box, etc, you have a choice of either adding the latexsym package or defining them in terms of the equivalent symbols from the amssymb package. ----------------------------------------- Questions concerning the use of AMSFonts may be directed to: Technical Support Publications Support Group American Mathematical Society 201 Charles Street P.O. Box 6248 Providence, RI 02940 USA (800) 321-4AMS (321-4267) ext. 4080 (401) 455-4080 Internet: tech-support@ams.org