%%% ==================================================================== %%% @LaTeX-file{ %%% author = "American Mathematical Society", %%% version = "1.2beta", %%% date = "27-Oct-1994", %%% time = "16:25:40 EDT", %%% filename = "amsldoc.tex", %%% copyright = "Copyright (C) 1994 American Mathematical Society, %%% all rights reserved. Copying of this file is %%% authorized only if either: %%% (1) you make absolutely no changes to your copy, %%% including name; OR %%% (2) if you do make changes, you first rename it %%% to some other name.", %%% address = "American Mathematical Society, %%% Technical Support, %%% Electronic Products and Services, %%% P. O. Box 6248, %%% Providence, RI 02940, %%% USA", %%% telephone = "401-455-4080 or (in the USA and Canada) %%% 800-321-4AMS (321-4267)", %%% FAX = "401-331-3842", %%% checksum = "40695 1968 9507 75586", %%% email = "tech-support@math.ams.org (Internet)", %%% codetable = "ISO/ASCII", %%% keywords = "latex, amslatex, ams-latex, amstex", %%% supported = "yes", %%% abstract = "This file is the source file for the AMS-\LaTeX{} %%% user's guide.", %%% docstring = "The checksum field above contains a CRC-16 %%% checksum as the first value, followed by the %%% equivalent of the standard UNIX wc (word %%% count) utility output of lines, words, and %%% characters. This is produced by Robert %%% Solovay's checksum utility.", %%% } %%% ==================================================================== \NeedsTeXFormat{LaTeX2e}% LaTeX 2.09 can't be used for this document \documentclass[leqno,titlepage,openany% %,draft ]{amsldoc} \title{\amslatex/ Version 1.2\\User's Guide} \author{American Mathematical Society} \date{October 1994} \usepackage[noamsfonts]{amstex} \usepackage{amscd} % The amsldoc class includes a number of features useful for % documentation about TeX, including: % % ---Commands \tex/, \amstex/, \latex/, ... for printing various % logos with proper ending spacefactor and convenient handling of % following spaces % % ---Commands for printing various common elements: \cn for command % names, \fn for file names (including font-file names), \env for % environments, \pkg and \cls for packages and classes, \opt for % package or class options, etc., etc. %\makeindex % generate index data \hfuzz=55pt % ignore overlong lines for the time being [mjd,12-Oct-1994] \vbadness=8000 % suppress `underfull' message, who cares? % Prepare for illustrating the \vec example \let\vector=\vec \renewcommand{\vec}[1]{\mathbf{#1}} \newcommand{\booktitle}[1]{\textit{#1}} \newcommand{\journalname}[1]{\textit{#1}} \newcommand{\seriesname}[1]{\textit{#1}} % An environment for presenting comprehensive address information: \newenvironment{infoaddress}{% \par\topsep\medskipamount \trivlist\centering \item[]% \begin{minipage}{.7\columnwidth}% \raggedright }{% \end{minipage}% \endtrivlist } \newenvironment{ctab}{% \par\topsep\medskipamount \trivlist\centering \item[]% \begin{tabular}% }{% \end{tabular}% \endtrivlist } % A command for ragged-right parbox in a tabular. \newcommand{\rp}{\let\PBS\\\raggedright\let\\\PBS} \newtheorem{prop}{Proposition} \newcommand{\ix}{\operatorname{ix}} \newcommand{\nul}{\operatorname{nul}} \newcommand{\End}{\operatorname{End}} \begin{document} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \frontmatter \maketitle \tableofcontents \newpage %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter*{What is `\amslatex/', and why would anyone want to use it?} \markboth{WHAT IS `\amslatex/'?}{WHAT IS `\amslatex/'?} \section*{What is `\amslatex/'?} The name \amslatex/ is used for convenience to describe a set of loosely related files that are distributed together by the American Mathematical Society. Basically they may be described as miscellaneous enhancements to \latex/ for \emph{superior information structure of mathematical documents} and \emph{superior printed output}. As \amslatex/ is an extension for \latex/, and \latex/ in turn is a `macro package'\gloss{macro package} for the \tex/ typesetting program, it follows that in order to use any of the pieces of \amslatex/ you need to have \tex/ and \latex/ installed first. \latex/ by itself does a rather good job of typesetting mathematics, compared to non-\tex/-based software; but it doesn't add much to the basic set of mathematical capabilities that it adopted from the Plain \tex/ macro package. At the same time that \latex/ was being developed by Leslie Lamport (roughly 1982--1986), the American Mathematical Society was throwing its resources into the development of a different macro package known as \amstex/, written by Michael Spivak. Eventually (by 1987 or so) it became evident that \amstex/ and \latex/ had complementary feature sets: \amstex/ focused on the typesetting of math formulas and on fine-tuning typically done by publishers, and was relatively weak in other areas (for example no automatic numbering or cross-reference facilities); \latex/ focused on document structure and logical markup of text, and had a comparatively limited set of features for dealing with math formula contents. This situation led to dissatisfaction among both \amstex/ and \latex/ users who saw desirable features tantalizingly just out of reach in the other macro package. So the American Mathematical Society looked into the question of producing some sort of combination of the two macro packages that would better serve mathematicians in their writing tasks. The decision that was eventually taken was to graft the mathematical capabilities of \amstex/ onto the base stock of \latex/ through an extension package: \amslatex/. The lion's share of the programming work was done by Frank Mittelbach and Rainer Sch\"opf in 1989--1990 and version 1.0 of \amslatex/ was released in mid-1990. \section*{Why would a \latex/ user want to bother with \amslatex/?} \markright{WHY BOTHER WITH \amslatex/?} If you are just starting out as a \latex/ user, you'll probably have to take our word for this (or the word of friends and colleagues), but: If your writing contains a significant proportion of mathematics, and you care about the quality of the printed results, then sooner or later you'll find shortcomings in standard \latex/ and want to remedy them. Chances are that at least the first few of the shortcomings you encounter will be ones that are already addressed by an \amslatex/ package. If you want to have maximum mathematical typesetting power ready at hand, rather than stop to cast about for a solution whenever you run into some unusual demand in your writing, then \amslatex/ will go a long way toward meeting your needs. If you are a long-time \latex/ user and have lots of mathematics in what you write, then how do these features sound: \begin{itemize} \item Easy access to extra math symbols as found in the AMSFonts font package, including blackboard bold and fraktur letters. And they change size properly through all the range of \latex/ font sizes, including sub\slash superscript sizes. \item A convenient way to define new `operator name' commands analogous to \cn{sin} and \cn{lim}, including proper side spacing and automatic selection of the correct font style and size (even when used in sub\slash superscripts). \item Multiple substitutes for the \env{eqnarray} environment to make various kinds of equation arrangements easier to write. \item Equation numbers automatically adjust up or down to avoid over-printing on the equation contents (unlike \env{eqnarray}). \item Spacing around equals signs matches the normal spacing in the \env{equation} environment (unlike \env{eqnarray}). \item A way to produce multiline subscripts as are often used with summation symbols. \item An easy way to substitute a variant equation number for a given equation instead of the automatically supplied number. \item An easy way to produce subordinate equation numbers of the form (1.3a) (1.3b) (1.3c) for selected groups of equations. \item Horizontal arrows that automatically expand to encompass wide subscripts or superscripts \item A \cn{boldsymbol} command for printing bold versions of individual symbols, including things like $\infty$ and lowercase Greek letters. \item A \env{cases} environment to make it easy to produce a typical case statement with large left brace, as in \begin{equation} P_{r-j}= \begin{cases} 0& \text{if $r-j$ is odd},\\ r!\,(-1)^{(r-j)/2}& \text{if $r-j$ is even}. \end{cases} \end{equation} \end{itemize} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \mainmatter %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{How to use \amslatex/} \section{Using an AMS package with a \latex/ document}\label{usepackage} \markright{USING AN AMS PACKAGE} A `package' in \latex/ terminology is an extension written in such a form that it can be used via the \cn{usepackage} command. Many of the principal features of \amslatex/ are provided in separate packages so that they can be used individually on demand. The \pkg{amstex} package is perhaps the single most noteworthy package, as it subsumes the \pkg{amsfonts}, \pkg{amstext}, and \pkg{amsbsy} packages, and provides a number of other enhancements for mathematical typesetting. Table~\ref{packages} gives the current list of packages. % We use the [b] option to keep this table from floating above the % chapter title. Depending on page breaking this might need changing % in the future. [mjd,26-Oct-1994] \begin{table}[b] \caption{Packages}\label{packages} \begin{ctab}{lp{.7\columnwidth}} \pkg{amstex}& \rp Defines extra environments for multiline displayed equations, as well as a number of other enhancements for math\\ \pkg{amstext}& \rp Provides a \cn{text} command for proper typesetting of a fragment of text inside a display\\ \pkg{amsbsy}& \rp Defines \cn{boldsymbol} and \cn{pmb} commands\\ \pkg{amsintsm}& \rp Provides more logical command syntax for \cn{int}, \cn{sum}\\ \pkg{amscd}& \rp Provides a \env{CD} environment for simple commutative diagrams (no support for diagonal arrows)\\ \pkg{amsthm}& \rp Provides a \env{proof} environment and extensions for the \cn{newtheorem} command \end{ctab} \end{table} The \pkg{amstex} package has the following options: \begin{description} \item[\opt{intlimits}] Place the subscripts and superscripts of integral symbols above and below rather than to the side (in displayed equations only). \item[\opt{nointlimits}] (default) Always place the subscripts and superscripts of integral symbols to the side. \item[\opt{sumlimits}] (default) Like \opt{intlimits}, but for sums and similar symbols ($\prod$, $\coprod$, $\bigotimes$, $\bigoplus$, and so forth). \item[\opt{nosumlimits}] Opposite of \opt{sumlimits}. \item[\opt{namelimits}] Like \opt{intlimits}, but for `operator names' such as $\det$, $\inf$, $\lim$, $\max$, $\min$ and so forth. \item[\opt{nonamelimits}] Opposite of \opt{namelimits}. \item[\opt{tbtags}] `Top-or-bottom tags': For a split equation, place equation numbers level with the last (resp.\ first) line, if numbers are on the right (resp.\ left). \item[\opt{centertags}] (default) For a split equation, place equation numbers vertically centered on the total height of the equation. \end{description} The \pkg{amstex} package also recognizes the following options which are usually given in the options list of the \cn{documentclass} command: \begin{description} \item[\opt{fleqn}] Position equations at a fixed indent from the left margin rather than centered in the text column. This option is typically inherited from the documentclass declaration, and so doesn't need to be specified explicitly in the \cn{usepackage} command. \item[\opt{reqno}] Place equation numbers on the right. \item[\opt{leqno}] Place equation numbers on the left. This option and the \opt{reqno} option are typically inherited from the documentclass declaration, so there is no default to speak of. \end{description} Example: \verb"\usepackage[intlimits]{amstex}". In compatibility mode obsolete option names \opt{intlim}, \opt{nosumlim}, \opt{nonamelm}, \opt{righttag} are recognized as well. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Documentation about amsart/amsbook document classes, included here % pending reorganization plans. \input{amscdoc.tx1} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{Displayed equations (\pkg{amstex} package)} \section{Introduction} The \pkg{amstex} package provides several environments for multi-line displayed equations. They are similar in function to \latex/'s \env{equation} and \env{eqnarray} environments. These environments are: \begin{verbatim} align gather alignat xalignat xxalignat multline split \end{verbatim} Each environment, except for \env{split}, has both starred and unstarred forms, where the unstarred forms have automatic numbering, using \latex/'s \env{equation} counter. You can suppress the number on any particular line by putting \cn{notag} before the \cn{\\}; you can also override it with a tag of your own using \cn{tag}|{|\