From 2e9d3a4357489717e65976ca468760b83a52d448 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 7 Apr 2018 20:51:30 +0000 Subject: amsmath (7apr18) git-svn-id: svn://tug.org/texlive/trunk@47349 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/amsmath/README.md | 106 ++ Master/texmf-dist/doc/latex/amsmath/README.txt | 107 -- Master/texmf-dist/doc/latex/amsmath/amsbsy.pdf | Bin 161325 -> 161335 bytes Master/texmf-dist/doc/latex/amsmath/amscd.pdf | Bin 165741 -> 165753 bytes Master/texmf-dist/doc/latex/amsmath/amsgen.pdf | Bin 164345 -> 164353 bytes Master/texmf-dist/doc/latex/amsmath/amsldoc.pdf | Bin 391683 -> 453062 bytes Master/texmf-dist/doc/latex/amsmath/amsldoc.tex | 1612 +++++++++++--------- Master/texmf-dist/doc/latex/amsmath/amsmath.pdf | Bin 378844 -> 378856 bytes Master/texmf-dist/doc/latex/amsmath/amsopn.pdf | Bin 129154 -> 129171 bytes Master/texmf-dist/doc/latex/amsmath/amstext.pdf | Bin 193892 -> 193904 bytes Master/texmf-dist/doc/latex/amsmath/amsxtra.pdf | Bin 104539 -> 104549 bytes Master/texmf-dist/doc/latex/amsmath/diffs-m.txt | 3 +- Master/texmf-dist/doc/latex/amsmath/subeqn.pdf | Bin 101285 -> 101296 bytes Master/texmf-dist/doc/latex/amsmath/subeqn.tex | 2 +- Master/texmf-dist/doc/latex/amsmath/technote.pdf | Bin 130465 -> 130475 bytes Master/texmf-dist/doc/latex/amsmath/testmath.pdf | Bin 428683 -> 428696 bytes Master/texmf-dist/source/latex/amsmath/amsbsy.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amsbsy.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amscd.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amscd.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amsgen.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amsgen.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amsmath.dtx | 6 +- Master/texmf-dist/source/latex/amsmath/amsmath.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amsopn.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amsopn.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amstext.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amstext.ins | 4 +- Master/texmf-dist/source/latex/amsmath/amsxtra.dtx | 4 +- Master/texmf-dist/source/latex/amsmath/amsxtra.ins | 4 +- Master/texmf-dist/tex/latex/amsmath/amsbsy.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amscd.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amsgen.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amsmath.sty | 4 +- Master/texmf-dist/tex/latex/amsmath/amsopn.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amstex.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amstext.sty | 2 +- Master/texmf-dist/tex/latex/amsmath/amsxtra.sty | 2 +- 38 files changed, 1016 insertions(+), 890 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/amsmath/README.md delete mode 100644 Master/texmf-dist/doc/latex/amsmath/README.txt (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/latex/amsmath/README.md b/Master/texmf-dist/doc/latex/amsmath/README.md new file mode 100644 index 00000000000..4bbba9630cd --- /dev/null +++ b/Master/texmf-dist/doc/latex/amsmath/README.md @@ -0,0 +1,106 @@ +## README for latex-amsmath bundle + + +### OVERVIEW + +The amsmath package is an extension package for LaTeX that provides +additional features to facilitate mathematical typesetting. It has been +developed by the American Mathematical Society and released for general +use as a service to the mathematical community. A number of smaller +auxiliary packages are also distributed with the amsmath package. + +Effective in 2016, maintenance of amsmath was transferred from AMS to +the LaTeX3 Project; as amsmath is considered a "required" package, this +centralizes control over the core LaTeX components. + + +### INSTALLATION AND GETTING STARTED + +In order to use amsmath you need to have TeX installed first. +For information on getting TeX see one of the following: + + - [LaTeX Project Website](https://www.latex-project.org/) + - [TeX User Group](https://www.tug.org/) + - [TeX resources (AMS infos for authors)](https://www.ams.org/tex/tex-resources) + +It is recommended to install a comprehensive distribution, such as +TeX Live, MiKTeX for Windows, or MacTeX for Macintosh. +As part of the "required" LaTeX package subset, amsmath +will already be available if one of these distributions is chosen. + +If you are installing amsmath manually, the most recent version +will be available from the CTAN archives +https://www.ctan.org/pkg/amsmath + + +The primary documentation for amsmath is in + + - amsldoc.pdf + +Additional documentation files include: + + - diffs-m.txt + - subeqn.pdf + - technote.pdf + - testmath.pdf + +which are included in the collection. All of these can be accessed +easily with most distributions by entering `texdoc` *filename* at the +command line, or via [TeXdoc Online](http://texdoc.net). + + + +### REMARKS ON THIS RELEASE + +#### Version 2.17 + +Fixes a bug in the spacing around the closing delimiter in generalised +fractions in xetex and luatex version added in release 2.16. +Fixes a bug that overfull lines did not always produce warnings. + + +### CHANGE LOG + +The file `changes.txt` lists recent changes in reverse chronological order. + +The file `diffs-m.txt` contains information on development and changes +prior to 2000. + + +### Reporting Bugs + +If you wish to report a problem or bug in any of these packages +please use the +[Issue Tracker for LaTeX2e on GitHub](https://github.com/latex3/latex2e/issues) +and follow the guidelines that pop up if you press the `New issue` button. + + +In particular, to check that you are really seeing a bug, please write +a short, self-contained document that shows the problem. This should +include the `latexbug` package, which will warn if your test file is +not suitable for one or the other reason. See the [CONTRIBUTING +guide](https://github.com/latex3/latex2e/blob/master/CONTRIBUTING.md) +for further details, or if you need to obtain the `latexbug` package. + +If the bug turns out to be with third-party software then please +contact the developer, and not us! + + +### Copyright + +Copyright 2001-2004, 2007, 2008, 2010, 2011, 2013 American Mathematical Society. +Copyright 2016-2017 LaTeX3 Project and American Mathematical Society. + +This work may be distributed and/or modified under the +conditions of the LaTeX Project Public License, either version 1.3c +of this license or (at your option) any later version. +The latest version of this license is in + https://www.latex-project.org/lppl.txt +and version 1.3c or later is part of all distributions of LaTeX +version 2005/12/01 or later. + +This work has the LPPL maintenance status `maintained'. + +The Current Maintainer of this work is the LaTeX3 Project. + +This README file is copyright 2016-2017 The LaTeX3 Project. diff --git a/Master/texmf-dist/doc/latex/amsmath/README.txt b/Master/texmf-dist/doc/latex/amsmath/README.txt deleted file mode 100644 index ceee2968d15..00000000000 --- a/Master/texmf-dist/doc/latex/amsmath/README.txt +++ /dev/null @@ -1,107 +0,0 @@ -README for latex-amsmath bundle -American Mathematical Society, LaTeX3 Project - -Copyright 2001-2004, 2007, 2008, 2010, 2011, 2013 American Mathematical Society. -Copyright 2016-2017 LaTeX3 Project and American Mathematical Society. - -This work may be distributed and/or modified under the -conditions of the LaTeX Project Public License, either version 1.3c -of this license or (at your option) any later version. -The latest version of this license is in - http://www.latex-project.org/lppl.txt -and version 1.3c or later is part of all distributions of LaTeX -version 2005/12/01 or later. - -This work has the LPPL maintenance status `maintained'. - -The Current Maintainer of this work is the LaTeX3 Project. - - - CONTENTS -I. OVERVIEW -II. INSTALLATION AND GETTING STARTED -III. SUBMITTING BUG REPORTS -IV. REMARKS ON THIS RELEASE -V. CHANGE LOG - -======================================================================== -I. OVERVIEW - -The amsmath package is an extension package for LaTeX that provides -additional features to facilitate mathematical typesetting. It has been -developed by the American Mathematical Society and released for general -use as a service to the mathematical community. A number of smaller -auxiliary packages are also distributed with the amsmath package. - -Effective in 2016, maintenance of amsmath was transferred from AMS to -the LaTeX3 Project; as amsmath is considered a "required" package, this -centralizes control over the core LaTeX components. - -======================================================================== -II. INSTALLATION AND GETTING STARTED - -In order to use amsmath you need to have TeX installed first. -For information on getting TeX see one of the following: - - http://www.tug.org/ - http://www.ams.org/tex/tex-resources - -It is recommended to install a comprehensive distribution, such as -TeX Live, MiKTeX for Windows, or MacTeX for Macintosh. -As part of the "required" LaTeX package subset, amsmath -will already be available if one of these distributions is chosen, - -If you are installing amsmath manually, the most recent version -will be available from the CTAN archives -https://www.ctan.org/pkg/amsmath - - -The primary documentation for amsmath is in - - amsldoc.pdf - -Additional documentation files include: - - diffs-m.txt - subeqn.pdf - technote.pdf - testmath.pdf - -which are included in the collection. All of these can be accessed -easily with most distributions by entering "texdoc filename" at the -command line, or via "TeXdoc Online" at http://texdoc.net . - -======================================================================== -III. SUBMITTING BUG REPORTS - -Bug reports should be submitted using the standard LaTeX bug reporting -system: - -See the form at - -http://www.latex-project.org/bugs/ - -and follow the resulting instructions. Select "amslatex" when asked -for a category. - -Questions regarding usage can be posted at http://tex.stackexchange.com . -Check first to see whether your question has already been answered. - -======================================================================== -IV. REMARKS ON THIS RELEASE - -Version 2.17 -Fixes a bug in the spacing around the closing delimiter in generalised -fractions in xetex and luatex version added in release 2.16. -Fixes a bug that overfull lines did not always produce warnings. - - -======================================================================== -V. CHANGE LOG - -The file changes.txt lists recent changes in reverse chronological order. - -The file diffs-m.txt contains information on development and changes -prior to 2000. - -[end] diff --git a/Master/texmf-dist/doc/latex/amsmath/amsbsy.pdf b/Master/texmf-dist/doc/latex/amsmath/amsbsy.pdf index b7649d8d501..f96445f48bc 100644 Binary files a/Master/texmf-dist/doc/latex/amsmath/amsbsy.pdf and b/Master/texmf-dist/doc/latex/amsmath/amsbsy.pdf differ diff --git a/Master/texmf-dist/doc/latex/amsmath/amscd.pdf b/Master/texmf-dist/doc/latex/amsmath/amscd.pdf index 4b4e9723fb0..48c7d0d6a2f 100644 Binary files a/Master/texmf-dist/doc/latex/amsmath/amscd.pdf and b/Master/texmf-dist/doc/latex/amsmath/amscd.pdf differ diff --git a/Master/texmf-dist/doc/latex/amsmath/amsgen.pdf b/Master/texmf-dist/doc/latex/amsmath/amsgen.pdf index 1719ddee46a..eefafeb74f5 100644 Binary files a/Master/texmf-dist/doc/latex/amsmath/amsgen.pdf and b/Master/texmf-dist/doc/latex/amsmath/amsgen.pdf differ diff --git a/Master/texmf-dist/doc/latex/amsmath/amsldoc.pdf b/Master/texmf-dist/doc/latex/amsmath/amsldoc.pdf index d589e2612fd..c532044c403 100644 Binary files a/Master/texmf-dist/doc/latex/amsmath/amsldoc.pdf and b/Master/texmf-dist/doc/latex/amsmath/amsldoc.pdf differ diff --git a/Master/texmf-dist/doc/latex/amsmath/amsldoc.tex b/Master/texmf-dist/doc/latex/amsmath/amsldoc.tex index d787f87c55f..1f46924b132 100644 --- a/Master/texmf-dist/doc/latex/amsmath/amsldoc.tex +++ b/Master/texmf-dist/doc/latex/amsmath/amsldoc.tex @@ -1,12 +1,12 @@ % % Copyright 1995, 2000, 2013 American Mathematical Society. -% Copyright 2016 LaTeX3 Project and American Mathematical Society. +% Copyright 2016-2018 LaTeX3 Project and American Mathematical Society. % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3c % of this license or (at your option) any later version. % The latest version of this license is in -% http://www.latex-project.org/lppl.txt +% https://www.latex-project.org/lppl.txt % and version 1.3c or later is part of all distributions of LaTeX % version 2005/12/01 or later. % @@ -21,17 +21,50 @@ \fbox{\fbox{\begin{tabular}{@{}l@{}}% This file is maintained by the \LaTeX{} Project team.\\% Bug reports can be opened (category \texttt{#1}) at\\% -\url{http://latex-project.org/bugs.html}.\end{tabular}}}\end{center}} +\url{https://latex-project.org/bugs/}.\end{tabular}}}\end{center}} \ifx\UndEfiNed\url \ClassError{amsldoc}{% This version of amsldoc.tex must be processed\MessageBreak - with a newer version of amsldoc.cls (2.02 or later)}{} + with a newer version of amsldoc.cls (2.02 or later).}{} \fi -\title{User's Guide for the \pkg{amsmath} Package (Version~2.0)} +\renewcommand\bibname{References} + +% Definitions that should be moved to amsldoc.cls +% when it is next updated +\makeatletter +\let\cleardouble@page\cleardoublepage +\AtBeginDocument{% + \ifx\cleardouble@page\cleardoublepage + \def\cleardoublepage{\clearpage{\pagestyle{empty}\cleardouble@page}} + \fi +} + +% #1 is empty or one of class, environment, option, package +% could use different font in each case +\makeatletter +\def\@category@index#1#2{% + \autoindex{% + #2\actualchar\string\index#1font{#2}% + \ifx\@nil#1\@nil\else\space#1\fi + }% +} + +\let\indexpackagefont\textsf +\let\indexclassfont\textsf +\let\indexoptionfont\texttt +\let\indexenvironmentfont\texttt +\let\indexfont\texttt +\makeatother +% For a package that won't be indexed, i.e. amsmath +\newcommand{\nipkg}{\textsf} +\def\tikz/{Ti\textit{k}Z} +% End definitions for amsldoc.cls + +\title{User's Guide for the \nipkg{amsmath} Package (Version~2.1)} \author{American Mathematical Society, \LaTeX3 Project} -\date{1999-12-13 (revised 2002-02-25, 2016-11-14)} +\date{1999-12-13 (revised 2002-02-25, 2016-11-14, 2018-04-05)} \makeatletter \def\@thanks{\bigskip\MaintainedByLaTeXTeam{amslatex}} \makeatother @@ -41,7 +74,21 @@ Bug reports can be opened (category \texttt{#1}) at\\% \usepackage{amsmath} \usepackage{amscd} -\makeindex % generate index data +\usepackage{imakeidx} +% Need alternate coding for vertical bar to get it into index. +% Based on \qcbang and \cnbang in amsldoc.cls, refined by David Carlisle. +% Give it a sort field that will be at the end of the symbols; +% must avoid " and | which have special meanings. +\DeclareRobustCommand{\qcvert}{\qc\|\index{{z1}@{\ntt\char'174}}} +\DeclareRobustCommand{\cnvert}{% + \ncn{\|}\index{{z0}@{\ntt\bslchar\char'174}}} +% Need alternate index sort field for bang to allow & to sort first +\DeclareRobustCommand{\altcnbang}{% + \ncn{\!}\index{"!b@{\ntt\bslchar\qcbang}}} +\DeclareRobustCommand{\cnamp}{% + \index{"!a@\texttt{\&}}} + +\makeindex[intoc] % generate index data \providecommand{\see}[2]{\textit{see} #1} % The amsldoc class includes a number of features useful for @@ -116,6 +163,18 @@ Bug reports can be opened (category \texttt{#1}) at\\% \par\addvspace\medskipamount } +% Errors in output shouldn't be \texttt, and they may also be longer +% than one line, but they should be identified by the "errorbullet". +% (They were formerly labeled as aubsections.) +\newenvironment{erroro}[1]{% + \par\addvspace\medskipamount + \noindent\hangindent\parindent + \hbox to\parindent{\errorbullet\hfil}\ignorespaces + #1\par\vspace{\smallskipamount} +}{% + \par\addvspace\medskipamount +} + % The chapters are so short, perhaps we shouldn't call them by the % name `Chapter'. We make \chaptername read an argument in order to % remove a following \space or "{} " (both possibilities are present @@ -168,6 +227,16 @@ Bug reports can be opened (category \texttt{#1}) at\\% % Include down to \section but not \subsection, in toc: \setcounter{tocdepth}{1} +% Subheadings for the bibliography +\newif\iffirstbibsubhead \firstbibsubheadtrue +\newcommand{\bibsubhead}[1]{% + \iffirstbibsubhead \firstbibsubheadfalse + \else \addvspace{\medskipamount} + \fi + \item[]\hspace*{-\leftmargin}\textbf{#1}\par + \vspace{\smallskipamount} +} + \DeclareMathOperator{\ix}{ix} \DeclareMathOperator{\nul}{nul} \DeclareMathOperator{\End}{End} @@ -195,34 +264,34 @@ Bug reports can be opened (category \texttt{#1}) at\\% \mainmatter \chapter{Introduction} -The \pkg{amsmath} package is a \LaTeX{} package that provides +\index{amsmath@\texttt{amsmath} package|(} + +The \nipkg{amsmath} package is a \LaTeX{} package that provides miscellaneous enhancements for improving the information structure and printed output of documents that contain mathematical formulas. Readers unfamiliar with \LaTeX{} should refer to \cite{lamport}. If you have an -up-to-date version of \LaTeX{}, the \pkg{amsmath} package is normally +up-to-date version of \LaTeX{}, the \nipkg{amsmath} package is normally provided along with it. Upgrading when a newer version of the -\pkg{amsmath} package is released can be done via -\url{http://www.ams.org/tex/amsmath.html} or -\url{ftp://ftp.ams.org/pub/tex/}. +\nipkg{amsmath} package is released can be done via +\url{http://mirror.ctan.org/macros/latex/required/amsmath.zip}. -This documentation describes the features of the \pkg{amsmath} package +This documentation describes the features of the \nipkg{amsmath} package and discusses how they are intended to be used. It also covers some ancillary packages: -\begin{ctab}{ll} -\pkg{amsbsy}& \pkg{amstext}\\ -\pkg{amscd}& \pkg{amsxtra}\\ -\pkg{amsopn} +\begin{ctab}{lll} +\pkg{amsbsy}& \pkg{amsopn}& \pkg{amsxtra}\\ +\pkg{amscd}& \pkg{amstext}\\ \end{ctab} These all have something to do with the contents of math formulas. For information on extra math symbols and math fonts, see \cite{amsfonts} -and \url{http://www.ams.org/tex/amsfonts.html}. For documentation of the +and \url{https://www.ams.org/tex/amsfonts.html}. For documentation of the \pkg{amsthm} package or AMS document classes (\cls{amsart}, -\cls{amsbook}, etc.\@) see \cite{amsthdoc} or \cite{instr-l} and -\url{http://www.ams.org/tex/author-info.html}. +\cls{amsbook}, etc.\@) see \cite{amsthdoc} or \cite{amshandbk} and +\url{https://www.ams.org/tex/author-info.html}. If you are a long-time \latex/ user and have lots of mathematics in what you write, then you may recognize solutions for some familiar problems -in this list of \pkg{amsmath} features: +in this list of \nipkg{amsmath} features: \begin{itemize} \item A convenient way to define new `operator name' commands analogous @@ -250,10 +319,10 @@ equation instead of the automatically supplied number. \end{itemize} -The \pkg{amsmath} package is distributed together with some small +The \nipkg{amsmath} package is distributed together with some small auxiliary packages: \begin{description} -\item[\pkg{amsmath}] Primary package, provides various features for +\item[\nipkg{amsmath}] Primary package, provides various features for displayed equations and other mathematical constructs. \item[\pkg{amstext}] Provides a \cn{text} command for @@ -275,23 +344,33 @@ is recommended instead. \end{description} -The \pkg{amsmath} package incorporates \pkg{amstext}, \pkg{amsopn}, and +The \nipkg{amsmath} package incorporates \pkg{amstext}, \pkg{amsopn}, and \pkg{amsbsy}. The features of \pkg{amscd} and \pkg{amsxtra}, however, are available only by invoking those packages separately. -\chapter{Options for the \pkg{amsmath} package}\label{options} +The independent \pkg{mathtools} package \cite{mt} provides some +enhancements to \nipkg{amsmath}; \pkg{mathtools} loads \nipkg{amsmath} +automatically, so there is no need to separately load \nipkg{amsmath} +if \pkg{mathtools} is used. Some \pkg{mathtools} facilities +will be noted below as appropriate. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\chapter{Options for the \nipkg{amsmath} package}\label{options} -The \pkg{amsmath} package has the following options: +The \nipkg{amsmath} package has the following options: +\index{options!amsmath@\texttt{amsmath} package options|(} \begin{description} -\item[\opt{centertags}] (default) For a split equation, place equation -numbers\index{equation numbers!vertical placement} vertically centered -on the total height of the equation. +\item[\opt{centertags}] (default) For an equation containing a +\env{split} environment, place equation +numbers\index{equationn@equation numbers!vertical placement} +vertically centered on the total height of the equation. -\item[\opt{tbtags}] `Top-or-bottom tags': For a split equation, place -equation numbers\index{equation numbers!vertical placement} level with -the last (resp.\@ first) line, if numbers are on the right (resp.\@ -left). +\item[\opt{tbtags}] `Top-or-bottom tags': For an equation containing +a \env{split} environment, place equation +numbers\index{equationn@equation numbers!vertical placement} level with the last +(resp.\ first) line, if numbers are on the right (resp.\ left). \item[\opt{sumlimits}] (default) Place the subscripts and superscripts\index{subscripts and superscripts!placement}\relax @@ -310,14 +389,16 @@ integral\index{integrals!placement of limits} symbols. \item[\opt{namelimits}] (default) Like \opt{sumlimits}, but for certain `operator names' such as $\det$, $\inf$, $\lim$, $\max$, $\min$, that -traditionally have subscripts \index{subscripts and -superscripts!placement} placed underneath when they occur in a displayed -equation. +traditionally have subscripts% +\index{subscripts and superscripts!placement} placed underneath when +they occur in a displayed equation. \item[\opt{nonamelimits}] Opposite of \opt{namelimits}. \end{description} +\goodbreak + \begin{description} \item[\opt{alignedleftspaceyes}] \item[\opt{alignedleftspaceno}] @@ -327,21 +408,25 @@ equation. To use one of these package options, put the option name in the optional argument of the \cn{usepackage} command\mdash e.g., \verb"\usepackage[intlimits]{amsmath}". +For AMS document classes and any other classes that preload \nipkg{amsmath} +desired options must be specified with the \cn{documentclass}\mdash +e.g.,\\ +\verb+\documentclass[intlimits,tbtags,reqno]{amsart}+. -The \pkg{amsmath} package also recognizes the following options which +The \nipkg{amsmath} package also recognizes the following options which are normally selected (implicitly or explicitly) through the \cn{documentclass} command, and thus need not be repeated in the option list of the \cn{usepackage}|{amsmath}| statement. \begin{description} -\item[\opt{leqno}] Place equation numbers on the left.\index{equation -numbers!left or right placement} +\item[\opt{leqno}] Place equation numbers on the left.% +\index{equationn@equation numbers!left or right placement} \item[\opt{reqno}] Place equation numbers on the right. \item[\opt{fleqn}] Position equations at a fixed indent from the left -margin rather than centered in the text column.\index{displayed -equations!centering} +margin rather than centered in the text column.% +\index{displayed equations!centering} \end{description} @@ -349,7 +434,7 @@ Three options have been added to control the space to the left of \env{aligned} and \env{gathered} environments. Prior to the 2017 release a thin space was added to the left but not the right of these constructs. This appears to have been an accidental feature of the implementation and -was typically corrected by prefixing the environments with \cn{\!}. +was typically corrected by prefixing the environments with \altcnbang. The new default behavior is aimed to ensure that the environments do not have a thin space added in most cases, and that existing documents @@ -361,50 +446,75 @@ using |\!\begin{aligned}| continue to work as before. \item[\opt{alignedleftspaceyesifneg}] Only add \cn{\,} if the environment is prefixed by negative space. (New default behavior.) \end{description} - +\index{options!amsmath@\texttt{amsmath} package options|)} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + \chapter{Displayed equations} \section{Introduction} -The \pkg{amsmath} package provides a number of additional displayed -equation structures\index{displayed - equations}\index{equations|see{displayed equations}} beyond the ones +The \nipkg{amsmath} package provides a number of additional displayed +equation structures\index{displayed equations}% +\index{equations|see{displayed equations}} beyond the ones provided in basic \latex/. The augmented set includes: \begin{verbatim} equation equation* align align* - gather gather* flalign flalign* - multline multline* alignat alignat* + gather gather* alignat alignat* + multline multline* flalign flalign* split \end{verbatim} (Although the standard \env{eqnarray} environment remains available, -it is better to use \env{align} or \env{equation}+\env{split} instead.) +it is better to use \env{align} or \env{equation}+\env{split} instead. +Within \env{eqnarray}, spacing\index{horizontal spacing} around signs +of relation is not the preferred mathematical spacing, and is +inconsistent with that spacing as it appears in other environments. +Long lines in this environment may result in misplaced or overprinted +equation numbers. This environment also does not support the use of +\cn{qed} or \cn{qedhere} as provided by theorem packages.) Except for \env{split}, each environment 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\index{equation numbers!overriding} it with a tag of your own -using \cn{tag}|{|\