Files in this directory

Name	Date	Size		Description
README	2002-01-17	9 Kbyte	download	Shown below

---

Contents of the README file

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/<resolution>

    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

Small print: This listing is regenerated periodically so there is a small chance that the directory has changed from what is shown here; to be sure, check the FTP listing.