summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/amstex/base/README
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-01-24 22:19:50 +0000
committerKarl Berry <karl@freefriends.org>2019-01-24 22:19:50 +0000
commit9550d7bc686e227f217834207ef8f6b42b44bb02 (patch)
tree835ef67c41f25943de04d171a39b625c64955b65 /Master/texmf-dist/doc/amstex/base/README
parent28ce99e6ad7fc066bae92899fa880557fb85b35a (diff)
amstex (24jan19)
git-svn-id: svn://tug.org/texlive/trunk@49810 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/amstex/base/README')
-rw-r--r--Master/texmf-dist/doc/amstex/base/README292
1 files changed, 37 insertions, 255 deletions
diff --git a/Master/texmf-dist/doc/amstex/base/README b/Master/texmf-dist/doc/amstex/base/README
index d5ff970dd43..269f5e26de2 100644
--- a/Master/texmf-dist/doc/amstex/base/README
+++ b/Master/texmf-dist/doc/amstex/base/README
@@ -1,270 +1,52 @@
-READ.ME for AMS-TeX version 2.2 2001/08/29
-
-AMS-TeX is a macro package that works with the TeX typesetting program.
-A working TeX system is a prerequisite for using any of the components
-of AMS-TeX. [TeX is not an AMS product; see the AMS TeX Resources page
-(http://www.ams.org/tex/tex-resources.html) for information if you
-do not already have TeX.]
-
-Obtain a printed copy of the full installation instructions:
- - Process amstinst.tex with Plain TeX, or
- - Print the amstinst.ps file provided.
-Read the instructions; they are much more complete than the summary
-provided here.
-
-The instructions assume that your TeX system is arranged according to
-the recommended TeX Directory Structure (TDS). Check the documentation
-for your TeX system to find out if it uses the TDS. A copy of the TDS
-report can be found at CTAN either as an online document
- .../tds/standard/tds
-or as a printable pdf file
- .../tds/standard/tds/tds.pdf
-Items on CTAN can usually be found through the CTAN Catalogue:
- http://www.ctan.org/search
-
-
-FILES IN THE AMS-TeX DISTRIBUTION
-
-A complete list of the files contained in the distribution is included
-in the installation instructions (amstinst).
-
-There are two basic methods of obtaining the files needed for AMS-TeX:
- - Retrieve one of the AMS-TeX bundles from the AMS FTP server
- ftp://ftp.ams.org/pub/tex/
- or the AMS web site
- http://www.ams.org/tex/amstex.html
- - Retrieve the individual files from one of the AMS servers or from CTAN
- .../macros/amstex/
-Install these files as described in the installation instructions
-(amstinst); a summary appears below, under INSTALLING AMS-TeX.
-
-Also, AMS-TeX will call for AMSFonts. Check the tfm-files subdirectory
- TEXMF/fonts/tfm/ams/
-to see whether it is already populated (most TeX distributions now
-include the AMSFonts). If not, retrieve the .tfm files for AMSFonts 2.2
-and install them into your system tfm-files subdirectory.
-
-These .tfm files can be retrieved in several ways:
- - as a bundle from the AMSFonts page on the AMS web site at
- http://www.ams.org/tex/amsfonts.html
- - as a tfm.tar file in the /pub/tex directory at the AMS FTP site,
- ftp://ftp.ams.org
- - as individual .tfm files from the /pub/tex/amsfonts/tfm subdirectory
- at the AMS FTP site or from CTAN in .../fonts/amsfonts/tfm
-(Note: set the file type to binary in FTP when transferring .tfm files.)
-Even if you do not use any symbols from the AMSFonts, you will need at
-least the .tfm files to use amsppt.sty and to TeX the accompanying
-documentation for AMS-TeX.
+README for AMS-TeX version 2.2 2019/01/18
+
+This is the final archival distribution of AMS-TeX. AMS-TeX is no
+longer supported by the AMS, nor is it used by the AMS publishing
+program. The AMS does not recommend creating any new documents using
+AMS-TeX; this distribution will be left on CTAN to facilitate
+processing of legacy documents and as a historical record of a
+pioneering TeX macro collection that played a key role in popularizing
+TeX and revolutionizing mathematics publishing.
+
+In addition to the "User's Guide to AMS-TeX" (doc/amsguide.pdf), the
+AMS is also making the full text of the most recent reprint of the
+second edition of "The Joy of TeX" by Michael Spivak available for the
+first time, as a pdf file. "Joy" can be found on CTAN:
+ http://mirrors.ctan.org/info/amstex-joy/joyt2.pdf
+
+The best way to install AMS-TeX is via the package manager for your
+TeX distribution. If that is not an option, instructions for manual
+installation are provided.
The following documentation files will be useful in installing and using
AMS-TeX.
-amstinst.tex - Installation instructions, comprising Appendices B and C
-amstinst.ps of amsguide, provided as both TeX source and ready-to-print
- PostScript.
-amsguide.tex - The AMS-TeX User's Guide, provided as both TeX source and
-amsguide.ps a ready-to-print PostScript file. When you have completed
- the installation of AMS-TeX 2.2, process the .tex file using
- AMS-TeX 2.2 and print the resulting .dvi file. The output
- will be a brief guide to using AMS-TeX 2.2, supplementing
- The Joy of TeX.
-joyerr.tex - The TeX input file for a document listing errata to
- The Joy of TeX prior to AMS-TeX 2.0. It also should be
- run through TeX using AMS-TeX 2.2.
-joyerr2.tex - The TeX input file for a document listing errata to the
- second edition of The Joy of TeX, for AMS-TeX 2.1 and up.
- Process with AMS-TeX 2.2 as for the other .tex files.
-amsppt.doc - Technical documentation for amsppt.sty, including an update
- history.
-amsppt.faq - Frequently asked questions and answers regarding AMS-TeX
- and amsppt.sty.
-
-
-INSTALLING AMS-TeX 2.2 ON YOUR SYSTEM -- A BRIEF OVERVIEW
-
-Backup any existing AMS-TeX files before installing a new release.
-
-Read the instructions in amstinst; they are more complete than these notes.
-
-If you have retrieved a bundled distribution and unbundled it with the
-appropriate tool, the files will be placed into the following subdirectories:
-
- TEXMF/doc/ams/amstex
- TEXMF/source/amstex
- TEXMF/tex/amstex/base
- TEXMF/tex/plain/amsfonts
-
-If you have retrieved individual files, you will need to place them into
-subdirectories as described in amstinst.ps.
-
-AMS-TeX will call for the AMSFonts 2.2 .tfm files. Check for their
-presence on your system and, if necessary, retrieve them and place them
-in the proper location as described above.
-
-Remember that most TDS sytems operate using a filename list or database,
-which must be updated when new files are added; consult your TeX system
-documentation for update instructions.
-
-Run amstex.ini through INITEX (the version of TeX which has no format
-preloaded, distributed with your implementation of TeX). It will produce
-a format file which will function as a preloaded version of AMS-TeX.
-Place this format file in the directory where your implementation of
-TeX looks for format files (see your system documentation), refresh the
-filename database, and you are ready to use AMS-TeX 2.2.
-
-If you habitually use the AMSPPT documentstyle, you may prefer to
-include it in the format file you create. This can be done by editing
-the file amstex.ini, using any text editor, and uncommenting the line
-that reads "\documentstyle{amsppt}". Before creating the format file,
-read Appendix C from the installation instructions.
-
-We recommend that, as a first test of your installation, you run the
-file amsguide.tex through TeX, and print out the output. This will
-provide further information about using AMS-TeX.
-
-========================================================================
-Highlights of the differences between versions 2.1 and 2.2:
-
-AMSTEX.TEX
-----------
-
----Removed copyright notice and restriction from message printed on
- terminal and in log for every run.
-
-AMSPPT.STY
-----------
-(See the user's guide (amsguide.tex) and amsppt.doc, section 20, for
-full details.)
-
----\subjclass was updated to use \subjclassyear as the date for the
-Mathematics Subject Classification scheme. (NOTE: THIS CHANGE IS NOT
-BACKWARD COMPATIBLE. EXISTING DOCUMENT FILES NEED NOT BE MODIFIED BUT
-THE OUTPUT WILL BE DIFFERENT IF CLASSIFICATION WAS OLDER THAN 1991.)
-
-========================================================================
-Highlights of the differences between versions 2.0 and 2.1:
-
-AMSTEX.TEX
-----------
----Improvements to the mechanisms for loading various fonts in
-the AMSFonts package. For example, \loadeusm now defines a
-\eusm command that can be used like \roman or \bold.
-
----Revamped \printoptions command.
-
----Some internal cleanup to reduce memory usage in some of TeX's
-memory categories (notably hash size).
-
----Informational messages appear on screen identifying the
-modules within amstex.tex during the creation of a format file.
-
-AMSPPT.STY
-----------
-(See the user's guide (amsguide.tex) and amsppt.doc, sections 18 and 19,
-for full details.)
-
----\curraddr was added, for giving the current address of an author,
-if different from the address given in \address.
+amstinst.tex - Installation instructions, comprising Appendices B and C
+amstinst.pdf of amsguide, provided as both TeX source and ready-to-print
+ PDF.
----\rom was added, for preventing unwanted italicization of certain
-things, such as parentheses or numbers, in theorems and other italic
-passages. \rom automatically inserts italic corrections.
+amsguide.tex - The AMS-TeX User's Guide, a brief guide to AMS-TeX 2.2,
+amsguide.pdf supplementing "The Joy of TeX".
----The implementation of \nofrills was completely changed, to provide
-better error messages for a missing or misspelled \endkeywords or
-similar end command when reading a delimited argument.
+joyerr2.tex - The AMS-TeX input file for a document listing errata to the
+ second edition of The Joy of TeX, for AMS-TeX 2.1 and up.
----Multiple \thanks commands in the top matter will now produce
-multiple acknowledgment footnotes instead of discarding all but the
-last one.
+The following documentation files will be useful in understanding the
+development and evolution of the code:
----A period is no longer added automatically at the end of a
-\thanks. (NOTE: THIS CHANGE IS NOT BACKWARD COMPATIBLE---DOCUMENT
-FILES WILL HAVE TO BE MODIFIED.)
+amstex.bug - Official record of bugs and changes made to AMS-TeX.
----\subjclassyear was added to specify the year of the Mathematics
-Subject Classification scheme. Only 1991 and 2000 are recognized,
-defaulting to 1991 to maintain some backward compatibility.
+CHANGELOG - Summary of changes made between versions 2.0 and 2.1
+ and between 2.1 and 2.2.
----\widestnumber\item now works as claimed in the User's Guide.
+amstex.txt - Technical documentation accompanying amstex.tex.
----The missing \par in the internal command \penaltyandskip@ was added.
+amsppt.doc - Technical documentation for amsppt.sty, including an update
+ history.
----Additional checks were added for runaway \proclaim, \definition,
-\ref, \roster, etc. The internal macro \runaway@ was changed to make
-its usage more consistent and robust; in the process its name was
-changed to \add@missing (and as the name suggests, it now tries to
-recover by adding the missing \end... command).
+amsppt.txt - Additional technical notes on amsppt.sty.
----As with amstex.tex, informational messages were added identifying the
-modules within amsppt.sty.
-
----The bibliography macros were substantially modified to correct
-another longstanding bug: line breaks after explicit hyphens,
-mathbins, and mathrels were inhibited. This also involved changing the
-\ref-specific version of \nofrills. BACKWARD COMPATIBILITY (WITH
-VERSION 2.0) IS NOT COMPLETE WITH RESPECT TO \nofrills IN THE
-BIBLIOGRAPHY MACROS. \nofrills NOW SHOULD ALWAYS FOLLOW IMMEDIATELY
-AFTER THE NAME OF THE FIELD TO WHICH IT APPLIES, E.G., \transl\nofrills,
-OR \paper\nofrills. This is more consistent with the usage of \nofrills
-outside of the references section. \nofrills will cause all the "frills",
-such as the parentheses around years in journal article citations, or
-words like "eds." or "vol." that are supplied automatically, to be
-omitted for the given field. In addition, it will suppress the
-automatic punctuation at the end of the field, if any.
-
----A \refstyle command was added to allow users to specify one of the
-three different reference styles most commonly used in AMS publications:
-letter labels in square brackets; unnumbered; and numbered (denoted A,
-B, and C, respectively). The syntax is "\refstyle{A}" (immediately after
-the \documentstyle command). Style C, numbered with arabic numerals, is
-the default selected by amsppt.sty. The \refstyle command ensures
-proper correspondence between the formatting of cites in the main text
-and the formatting of the references section. Also, \key can now be used
-for all reference labels, and the \no command is redundant (though still
-supported, for backward compatibility).
-
----\miscnote was added, and used in the implementation of \toappear,
-so that \toappear and \finalinfo would not be mutually exclusive.
-\miscnote might also be used for things like "preprint" or
-"submitted". Unlike \finalinfo, \miscnote automatically adds
-parentheses.
-
----\procinfo was added, to give place and date where the meeting
-took place, for a proceedings volume reference.
-
----\eds or \ed information will now be used in place of an author's
-name, if \by is absent. This would be for collections or proceedings
-volumes that are cited as a whole, instead of citing a single paper
-within the volume.
-
-AMSTEX.INI
-----------
-File to make format file creation more convenient. See the
-user's guide and/or installation notes above.
-
-AMSPPT1.TEX
------------
-Compatibility file to allow processing of AMS-TeX 1.1 and earlier
-documents under AMS-TeX 2.0+. See the user's guide.
-
-
-(NOTE: Author packages for use with AMS-TeX are available from the AMS
-web site at http://www.ams.org/tex/author-info.html, or by FTP from
-ftp://ftp.ams.org/pub/author-info/packages. All packages are compatible
-with AMS-TeX 2.2. If you have previously received an AMS-TeX author
-package for use with an earlier version of AMS-TeX, for best results you
-should retrieve an upgraded copy from the AMS server.)
+amsppt.faq - Frequently asked questions and answers regarding AMS-TeX
+ and amsppt.sty.
========================================================================
-
-Questions or comments can be directed to:
-
-Technical Support
-American Mathematical Society
-201 Charles Street
-P.O. Box 6248
-Providence, RI 02940 USA
- (800) 321-4AMS (321-4267) ext. 4080 (U.S. and Canada)
- (401) 455-4080
-Email: tech-support@ams.org